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PREFACE 


This  document  is  intended  to  serve  as  a specifications  document,  design  docu- 
ment, system  description,  and  user's  manual.  Because  of  the  different  uses 
intended,  and  because  four  different  computer  programs  are  involved,  it  has 
been  written  in  modular  form.  Each  section  may  be  used  independently,  except 
that  definitions  given  in  Sections  i and  2 are  used  throughout. 

Section  1 is  an  introduction  to  the  SKYMAP  star  catalog  svstam  and  data  base. 
Section  2 provides  a svstem  overview  and  specifies  how  each  program  fits  into 
the  system.  Section  3 contains  the  scientific  procedures  used  to  gather  and 
analyze  the  data  that  forms  the  pnmarv  data  base.  Section  4 _s  a descript. on 
of  the  format  of  this  data  base  and  a definition  of  each  data  word.  Section  o 
through  9 contain  detailed  software  descriptions  of  each  program  in  the  svstem. 

This  revision  incorporates  minor  changes  necessitated  by  discovery  of  various 
errors  or  shortcomings  in  the  SKYMAP  system. 
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ABSTRACT 


This  document  details  the  specifications , design,  software  description,  and  use 
of  the  SKYbLAP  star  catalog  system.  The  SKYblAP  system  was  developed  to 
provide  an  accurate  and  complete  catalog  of  all  stars  with  blue  or  visual  magni- 
tudes brighter  than  9.  0 for  use  by  attitude  determination  programs.  Because 
of  the  large  number  of  stars  which  are  brighter  than  9.  0 magnitude,  efficient 
techniques  of  manipulating  and  accessing  t.ne  data  were  required.  These  tech- 
niques of  staged  distillation  of  data  from  a blaster  Catalog  to  a Core  Catalog, 
and  direct  access  of  overlapping  zone  catalogs,  form  the  basis  of  the  SKYblAP 
system. 

The  collection  and  transformation  of  data  required  to  produce  the  blaster  Catalo 
data  base  is  described.  The  data  rlow  through  the  main  programs  and  levels  of 
star  catalogs  is  detailed.  The  mathematical  and  logical  techniques  lor  each 
program  and  the  format  of  all  catalogs  are  documented. 
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SECTION  1 - INTRODUCTION 


SKY  MAP*  is  a collection  of  four  computer  programs  leading  to  the  creation, 
maintenance,  and  use  of  a series  of  star  catalogs;  these  catalogs  contain  ac- 
curate positional  and  magnitude  information  suitable  for  use  by  attitude  determi- 
nation and  analysis  programs  using  star  camera  data.  By  "star  camera,"  we 
refer  to  a nonintegrating  scanning/  tracking  photometer.  The  star  camera  is 
used  as  an  attitude  determination  sensor  by  comparing  observed  star  positions 
with  positions  of  real  stars  taken  from  a star  catalog  ^ee,  for  example.  Ref- 
erence 1).  SKYMAP  has  been  designed  primarily  to  satisfy  "he  requirements 
imposed  by  the  Bail  Brothers  Research  Corporation  CBBRCj  star  camera  <see 
Reference  2).  Star  catalogs  used  by  previous  missions  such  as  the  Small  As- 
tronomy 3atellite-A  and-B,  the  Orbiting  Solar  Observatory -I  and  K,  and  the 
Small  Scientific  Satellite  are  not  adequate  because  they  do  not  contain  many  of 
the  relatively  dim  stars  which  are  detectable  by  the  BBRC  instrument. 

The  only  two  existing  catalogs  which  contain  a large  proportion  of  the  recuired 
stars  are  the  Henry  Draper  (HD)  (Reference  3)  and  Smithsonian  Astrophy steal 
Observatory  (SAO)  (Reference  4)  catalogs.  Neither  of  these  has  star  magni- 
tudes sufficiently  accurate  for  the  purposes  discussed  below.  Therefore,  a new 
catalog  had  to  be  created  by  merging  data  from  the  HD,  SAO.  and  other  catalogs 
(see  Section  3). 


iThe  term  "SKYMAP1*  will  be 


used  to  refer  to  the  entire  collection 
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1.1  THE  NEED  FOR  SKYMAP 

Star  cameras  similar  to  the  BBRC  instrument  are  being  used  or  are  planned  on 
a large  number  of  spacecraft,  including  the  following: 

• Small  Astronomy  Satellite-C  (SAS-C) 

• High  Energy  Astronomy  Observatory  (HEAO-A,  -B,  and  -C) 

• International  Ultraviolet  Explorer  (IUE) 

• Multimission  Modular  Satellite  (MMS)  series,  including  AIRSAT, 
LANDSAT-D,  STORMSAT,  and  the  Gamma  Ray  Explorer  (GRE) 

For  these  spacecraft  missions,  fine  attitude  determination  with  an  accuracy  on 
the  order  of  1 arc-minute  or  better  will  be  dependent  upon  star  camera  data. 
Except  for  SAS-C,  rough  attitude  determination,  with  an  accuracy  on  the  order 
of  1 degree,  will  also  primarily  rely  on  star  camera  data. 

To  calculate  an  attitude  from  star  camera  data,  one  must  be  able  to  identify  the 
stars  which  were  observed  by  the  camera.  The  basis  of  many  star  identifica- 
tion algorithms  is  some  form  of  pattern  matching.  This  technique  may  fail  if 
there  are  insufficient  star  observations,  if  the  reference  star  catalog  does  not 
contain  stars  which  the  camera  observed,  or  if  the  reference  star  catalog  con- 
tains too  many  stars  not  observable  by  the  camera. 

Star  observations  may  be  scarce  because  the  period  of  analysis  must  be  kept 
sufficiently  small  so  that  the  spacecraft  motion  is  known  over  the  interval. 

For  SAS-C,  some  analysis  segments  contain  no  more  than  five  or  six  valid 
observed  data  points.  Therefore,  :t  is  important  that  as  few  observed  data 
points  as  possible  be  Most"  due  to  catalog  incompleteness. 
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Ideally,  the  star  catalog  will  contain  all  and  only  those  stars  that  the  camera 
might  see.  This  avoids  extraneous  points  in  the  reference  pattern  with  which 
the  observed  pattern  must  be  matched.  In  practice,  it  is  impossible  to  reach 
this  ideal. 

Stars  near  the  detection  limit  of  the  camera  will  not  be  observed  consistently 
because  of  photon  statistics  and  the  slowly  changing  sensitivity  of  the  camera. 
Therefore,  the  catalog  must  either  (1)  contain  these  stars,  and  hence  contain 
stars  which  sometimes  are  not  observable,  or  (2)  not  contain  them,  thereby 
lacking  stars  that  sometimes  are  observable.  If  it  is  necessary  to  maximize 
the  use  of  observed  data,  even  stars  with  a low  probability  of  detection  must  be 
included  in  the  catalog. 

An  ideal  star  catalog  would  also  contain  exact  magnitude  information.  However, 
brightness  of  the  catalog  stars  is  not  precisely  known.  Star  magnitudes  are 
routinely  measured  on  the  Ultraviolet-Blue-Visual  (UBV)  system  established  by 
Johnson  (see  Reference  5).  UBV  magnitudes  are  not  available  for  many  of  the 
dimmer  stars  detectable  by  the  BBRC  star  camera.  For  these  stars,  the  rela- 
tively inaccurate  photovisual-photographic  magnitudes  reported  in  the  HD  and 
SAO  catalogs  must  be  used.  However,  the  star  camera  sensitivity  normally 
does  not  match  exactly  any  of  the  filter-photometer  combinations  of  these  sys- 
tems. Therefore,  stellar  magnitude  data  must  be  converted  to  the  magnitude 
as  seen  by  the  star  camera,  called  the  ’’instrumental  magnitude." 

If  the  instrumental  magnitudes  in  the  star  catalog  are  not  precise,  it  is  im- 
possible to  eliminate  stars  which  are  too  faint  to  be  detected  by  the  camera 
without  inadvertantly  eliminating  others  which  are  sufficiently  bright.  There- 
fore, if  the  goal  is  catalog  completeness,  it  is  necessary  to  include  more  stars 
in  the  catalog  than  would  otherwise  be  needed  for  a specific  application.  The 
instrumental  magnitude  must  be  determined  with  as  much  precision  as  is  pos-, 
sible,  so  that  the  size  of  the  catalog  is  minimized,  thereoy  saving  computing 
time  and  decreasing  the  probability  of  misidentifications. 
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1 . 2 REQUIREMENTS  OF  THE  SKYMAP  CATALOG 

The  SKYMAP  catalog  will  be  used  by  star  identification  routines  and  fine  atti- 
tude determination  routines.  For  the  former,  it  must  be  complete  to  the 
camera's  limiting  magnitude,  have  accurate  instrumental  magnitudes  and  rea- 
sonably accurate  positions;  for  the  latter,  it  must  contain  accurate  star  posi- 
tions. Other  information,  such  as  data  on  multiple  stars  or  stars  of  variable 
brightness,  should  also  be  included  so  that  analytical  programs  can  avoid  using 
such  stars,  if  this  is  desirable. 

In  order  to  support  the  BBRC  star  camera,  which  will  be  used  on  the  SAS-C  and 
HEAO-A  spacecraft,  the  following  attributes  are  required  for  the  SKYMAP 
catalog: 

o It  must  contain  all  stars  with  either  blue  (B)  or  visual  (V)  magnitude 
brighter  than  9.0. 

• It  must  contain  star  positions  (epoch  2000.  0)  accurate  to  1 arc- 
second.  Less  accurately  known  positions  must  be  flagged. 

• It  must  contain  proper  motions  to  allow  calculation  of  the  star 
positions  at  epochs  other  than  2000. 0 with  minimum  degradation  of 
positional  accuracy. 

• It  must  contain  observed  or  derived  UBV  magnitudes  for  all  stars. 

• It  must  contain  information  concerning  the  spectral  energy  distribu- 
tion of  the  catalog  stars  in  order  to  assist  in  accurate  calculation  of 
instrumental  magnitudes. 

• It  must  contain  data  concerning  multiple  star  systems  and  stars  of 
variable  brightness  for  editing  purposes. 
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1.3  THE  NEED  FOR  SEVERAL  FORMS  OF  THE  CATALOG 

To  fulfill  the  requirements  of  the  SKYMAP  catalog  stated  above,  approximately 
255,000  stars  must  be  included  in  the  catalog.  With  540  bytes  of  data  per 
star,  this  requires  over  135  million  bytes  of  storage. 

Clearly,  such  a large  catalog  is  not  suitable  for  day-to-day  operations.  It  may 
be  too  large  to  store  conveniently  on  disk  and  would  take  too  much  time  to 
access.  On  the  other  hand,  fewer  stars  m the  catalog  or  fewer  data  words  per 
star  would  make  it  impossible  to  fulfill  the  completeness  and  accuracy  require- 
ments for  the  catalog. 

The  solution  is  the  use  of  a hierarchy  of  three  catalogs.  The  rirst  is  called  the 
"Master  Catalog1'.  It  contains  all  SKYMAP  data  (540  bytes)  for  all  the  stars 
within  the  9.0  magnitude  limit.  Due  to  its  size,  the  Master  Catalog  lS  normally 
stored  on  tape. 

The  second  level  is  the  "Mission  Catalog",  which  contains  that  subset  of  Master 
Catalog  data  relevant  to  a particular  spacecraft  mission,  and  is  created  from 
the  Master  Catalog.  When  creating  the  Mission  Catalog,  unneeded  parameters 
in  the  Master  Catalog  may  be  dropped,  or  a brighter  limiting  magnitude  may 
be  established.  Parameters  which  will  not  change  over  long  periods  of  tune 
(for  example,  star  positions  at  a selected  epoch)  ma}'  be  calculated  and  stored 
in  the  M ission  Catalog.  The  Mission  Catalog  will  be  much  smaller  than  the 
Master  Catalog.  Because  accessing  the  Master  Catalog  to  create  the  Mission 
Catalog  is  time  consuming,  the  Mission  Catalog  should  contain  ;-nough  data  so 
that  miner  changes  in  star  camera  operational  parameters  during  the  course 
of  mission  support  do  not  make  it  necessary  to  re-create  it. 

The  Mission  Catalog  is  optional.  All  SKYMAP  programs  chat  would  read  :he 
Mission  Catalog  can  read  the  Master  Catalog  instead.  The  advantage  of  using 
a Mission  Catalog  is  the  decreased  computer  time  needed  :o  read  it.  Howeter, 
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if  it  is  not  possible  to  define  the  parameters  which  will  be  required  by  a mission 
before  program  development,  it  may  be  impossible  to  define  a Mission  Catalog. 

The  third  level  in  the  catalog  hierarchy  is  the  ’’Run  Catalog".  The  Run  Catalog, 
used  on  a day-to-day  basis  by  attitude  determination  programs,  is  created  as  a 
subset  of  the  Mission  Catalog.  It  contains  the  minimum  data  needed  by  attitude 
determination  programs — the  star  number  and  the  star  position  at  a specific 
epoch.  Up  to  four  additional  words  of  information  may  also  be  included;  these 
may  include,  for  example,  instrumental  magnitude,  spectral  type,  position 
quality  flag,  or  angular  distance  to  the  nearest  neighboring  star. 

The  Run  Catalog  contains  the  minimum  number  of  stars  allowable  consistent 
with  the  limiting  magnitude  constraint.  If  any  of  the  parameters  in  the  Run 
Catalog  must  be  updated  during  the  mission,  it  is  regenerated  from  the  Mission 
or  Master  Catalog.  For  example,  should  the  instrumental  wavelength  response 
of  the  star  camera  change,  the  Run  Catalog  would  be  re-created. 

Therefore,  the  Run  Catalog  is  as  small  as  is  operationally  feasible.  For 
3AS-C,  it  contains  approximately  21,000  stars  and  5 words  of  data  per  star. 
Because  there  is  some  data  redundancy  and  a small  amount  of  unused  space 
required  by  the  storage  and  retrieval  techniques,  estimates  of  how  much  disk 
storage  is  needed  are  deferred  until  Section  6. 

Although  the  Run  Catalog  is  as  small  as  possible,  it  is  still  not  efficient  to  have 
to  read  the  entire  catalog  every  time  it  is  accessed.  For  this  reason,  the  Run 
Catalog  is  presorted  into  zones.  This  scheme  minimizes  core  storage  and  com- 
puter time  requirements  for  programs  which  use  the  star  catalog,  at  the  ex- 
pense of  a modest  amount  of  disk  storage.  A full  description  of  zone  definition 
is  contained  in  Section  3. 

The  Run  Catalog  is  output  either  as  a direct-access  disk  file,  or  as  i sequential 
cape  file  from  which  the  disk  file  can  be  created.  Analytical  programs  use  this 
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disk  file  in  conjunction  with  an  interface  program  to  retrieve  the  star  catalog 
data. 

SKYMAP  provides  the  software  to  read  the  Run  Catalog  and  create  a star  catalog 
in  computer  core.  This  will  be  referred  to  as  the  "Core  Catalog".  Strictly 
speaking,  it  is  not  a member  of  the  SKYMAP  hierarchy  of  catalogs  because  it 
is  not  a permanent  data  set,  but  the  Core  Catalog  will  be  discussed  extensively 
in  Sections  3 through  9. 

1.4  GENERAL  REQUIREMENTS  FOR  THE  SKYMAP  SYSTEM 

The  following  SKYMAP  capabilities  provide  for  the  creation,  maintenance,  and 
use  of  one  or  more  of  the  star  catalogs: 

9 Gathering,  sorting,  and  analyzing  the  data  necessary  for  the  crea- 
tion of  the  Master  Catalog. 

• Providing  for  selection  of  a subset  of  the  Master  Catalog  to  be  in- 
cluded in  the  Mission  Catalog.  .SKYMAP  allows  the  user  to  generate 
secondary'  parameters  based  upon  data  contained  in  the  Master  Cat- 
alog (such  as  position  at  a specified  epoch). 

• Creating  a sequential  (tape)  version  of  the  Run  Catalog. 

• Providing  for  the  transfer  of  the  entire  sequential  Run  Catalog,  or 
any  part  thereof,  to  a direct-access  (disk)  file. 

• Allowing  for  updating  data  in  the  Master  and  Mission  Catalogs  and 
adding  new  data  as  it  becomes  available. 

® Providing  routines  for  efficient  interfacing  of  analytical  routines 
with  the  star  catalogs. 
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SECTION  2 - SYSTEM  OVERVIEW 


3KYMAP  can  be  visualized  as  both  (1)  a primary  data  base,  called  the  Master 
Catalog,  which  contains  data  relevant  to  the  calculation  of  stellar  positions  and 
magnitudes,  and  (2)  a series  of  computer  programs  which  prepare  this  data  for 
use  by  attitude  determination  programs. 

The  Master  Catalog  was  created  by  merging  data  from  11  star  catalogs. 

Reference  -14  summarizes  the  catalogs  used.  Based  on  the  information  con- 
tained in  these  catalogs,  a number  of  additional  parameters  are  computed  and 
entered  into  the  Master  Catalog. 

Given  the  existence  of  the  Master  Catalog,  four  SKYMAP  programs  provide 
efficient  access  to  the  data.  Figure  2-1  shows  the  system  data  flow  starting 
with  the  Master  Catalog  and  ending  with  use  of  the  data  by  the  attitude  deter- 
mination programs. 

Program  UPDATE  is  used  to  select  a subset  of  Master  Catalog  data  needed  by 
a specific  mission,  and  also  provides  for  the  calculation  of  additional  mission- 
dependent  parameters  based  on  Master  Catalog  data.  The  output  from  UPDATE 
is  the  Mission  Catalog.  UPDATE  may  also  be  used  to  correct  Master  Catalog 
data,  add  stars  to  or  delete  stars  from  the  Master  Catalog,  and  provide  printed 
output  of  Master  Catalog  data. 

The  Mission  Catalog  (or  the  Master  Catalog  if  no  Mission  Catalog  is  used)  is 
sorted  by  program  CAT  into  subcataiogs  covering  overlapping  zones  in  the  sky. 
Such  presorting  is  required  because  the  Mission  Catalog  is  nor  mail  v too  large 
to  be  stored  in  core  or  to  be  sorted  for  each  application. 

The  output  from  CAT  is  the  Run  Catalog,  which  can  be  in  either  sequential  or 
direct-access  format,  if  the  direct-access  output  ion  diskt  is  chosen,  then  the 
Run  Catalog  can  be  accessed  directly.  If  sequential  output  -,on  cape:  :s  chosen, 
program  SWITCH  must  be  used  to  read  the  entire  Run  Catalog,  or  any  specified 
subset  of  it,  and  place  it  on  direct-access  disk  file.  Conservation  ci  disk  storage 
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is  realized  by  using  tape  output  from  CAT  and  converting  only  that  subset  of 
the  Run  Catalog  for  which  an  immediate  need  is  anticipated  to  direct-access 
format  (using  SWITCH). 

Attitude  determination  programs  access  the  Run  Catalog  by  use  of  program 
LOOKAT,  which  requires  a direct-access  version  of  the  Run  Catalog  as  input. 

A call  to  a LOOKAT  driver  subroutine  causes  LOOKAT  to  read  the  Run  Catalog 
and  store  the  star  data  for  the  required  part  of  the  sky  in  the  Core  Catalog. 

Using  the  Run  Catalog  as  input,  the  statistics  module  of  LOOKAT  produces  plots 
of  stars  in  selected  portions  the  sky  and  statistical  information  concerning  star 
density.  The  remainder  of  this  section  is  a more  detailed  discussion  of  the 
capabilities  of  each  segment  of  5KYMAP. 

2. 1 THE  MASTER  CATALOG 

The  Master  Catalog  is  a data  base  from  which  3KYMAP  programs  produce  the 
Mission  and  Run  Catalogs.  It  contains  all  the  information  necessary  to  compute 
stellar  positions  and  instrumental  magnitudes  to  as  high  a precision  as  possible. 
It  also  contains  information  on  multiple  and  variable  stars  to  be  used  for  editing. 
The  Master  Catalog  contains  all  known  stars  with  either  a B or  V magnitude 
brighter  than  9.0.  The  limiting  magnitude  has  been  chosen  to  ensure  that  all 
stars  detectable  by  star  cameras  similar  to  the  BBRC  instrument  are  included 
in  the  Master  Catalog.  A technique  for  analyzing  the  completeness  of  a star 
catalog  is  given  in  Reference  45 . 

2.1.1  T;pes  of  Data  Included  in  the  Master  Catalog 

The  Master  Catalog  contains  data  for  the  following  tour  purposes: 

» Cross-referencing  the  star  to  other  catalogs 

* Calculating  the  star’s  instrumental  magnitude 

• Calculating  the  star's  position  at  any  given  epoch 
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• Determining  the  star's  positional  error,  distance  from  other  stars, 
and  magnitude  variability  for  use  by  data  editing  algorithms 

The  main  reference  star  number  is  the  SKYMAP  catalog  number,  assigned  as 
specified  in  Section  3.  Several  other  catalog  numbers  are  available  to  assist 
in  cross-referencing  stars  with  other  printed  catalogs. 

The  calculation  of  the  star's  instrumental  magnitude  for  inclusion  in  the  Run 
Catalog  usually  requires  detailed  information  on  the  spectral  energy  distribu- 
tion of  the  star  as  seen  from  the  Earth.  The  standard  system  of  measuring 
stellar  brightness  is  the  UBV  system  i Reference  5).  Tins  system  provides 
measurements  taken  with  instrumental  profiles  of  effective  wavelength  around 
3500  Angstroms  (A)  (Ultraviolet),  4400A  (Blue)  and  5500A  (Visual)  (i.e. , UBV). 
The  profile  full  widths  at  half  maximum  transmissivity  (the  "half  widths")  are 
about  900A.  Unfortunately,  about  half  the  stars  in  the  Master  Catalog  had  no 
observed  UBV  measurements.  Therefore,  it  was  necessary  to  convert  the  less 
accurate  photographic  and  photovisual  magnitudes  from  Reference  3 or  Refer- 
ence 4 into  equivalent  UBV  magnitudes.  This  is  accomplished  by  deducing  the 
overall  energy  distribution  from  the  existing  magnitudes,  the  spectral  type,  and 
information  on  interstellar  reddening.  The  interstellar  reddening,  in  turn,  is 
usually  deduced  from  the  distance  of  the  star  and  its  position  in  galactic  coordi- 
nates. Section  3 and  Reference  6 contain  more  detailed  descriptions  of  how  in- 
strumental magnitudes  can  be  calculated  from  information  contained  in  the 
Master  Catalog.  To  enable  calculation  of  the  instrument  magnitude,  the  Master 
Catalog  contains,  when  available,  the  following: 

• HD  photographic  and  photovisual  magnitudes  .one  or  the  ocher  is 
almost  always  available) 

• HD  spectral  ape  (virtually  always  available! 

• Spectral  type  and  luminosity  class  on  the  modem  Morgan-Keenan 
(MK)  system  (Reference  7l 
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• UBV  magnitudes  / 

• Radial  velocity  (to  help  derive  stellar  distance) 

• Heliocentric  parallax  (to  help  derive  stellar  distance) 

• A derived  stellar  distance  (to  calculate  the  reddening  index) 

• A derived  reddening  index 

• Derived  values  of  the  UBV  magnirudes  where  no  measurements 

exist 

» Various  data  sources  and  quality  flags 

To  calculate  the  star's  position  at  a given  epoch,  the  following  are  included: 
a The  right  ascension  and  declination  at  epoch  2000.  0 

• The  proper  motion  in  the  directions  of  right  ascension  and  declina- 
tion 

Additionally,  the  Master  Catalog  contains  information  on  stars  having  variable 
brightness  and/or  multiple  stars  to  allow  the  user  to  identify  and/or  edit  such 
stars  from  computations. 

2.1.2  Generation  of  the  Master  Catalog 

The  Master  Catalog  is  generated  by  combining  the  data  from  various  existing 
catalogs.  Because  existing  catalogs  generally  contain  only  one  or  two  types  of 
data,  it  is  necessary  to  combine  them  before  derived  values  of  the  distance, 
reddening  index,  and  UBV  magnitudes  can  be  calculated.  The  process  a:  gat.te 
tag  the  data  is  described  in  Section  3;  Section  3 also  details  how  acditionai  par 
eters  have  been  computed  from  the  basic  data. 

2.2  THE  MISSION  CATALOG 

Tor  a specific  application,  die  Mission  Catalog  is  smaller  and  more  converden 
:o  use  train  die  Master  Catalog.  It  is  smaller  because  only  those  stars  bright 
enough  to  be  of  interest  to  the  mission  are  retained,  amd  because  much  star  da 
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contained  in  the  Master  Catalog  can  be  discarded  or  combined  into  more  com- 
pact form  once  mission -dependent  parameters  are  known.  For  example,  posi- 
tional and  proper  motion  data  in  the  Master  Catalog  are  combined  into  position 
at  the  mission  epoch  in  the  Mission  Catalog. 

The  Mission  Catalog  is  not  required  because  the  Master  Catalog  can  be  sub- 
stituted for  it.  This  substitution,  however,  leads  to  increased  computing  time. 

2.2.1  Variables  Contained  in  the  Mission  Catalog 

The  Mission  Catalog  is  complete  down  to  a limiting  magnitude  specified  by  the 
user,  but  not  to  exceed  that  of  the  Master  Catalog.  The  method  of  computation 
of  the  instrumental  magnitude  is  also  left  to  the  user. 

The  Mission  Catalog  normally  contains  the  following  minimum  data: 

• HD  number 

® Position  (right  ascension  and  declinationi  at  a user-specified  epoch 

• B and  V magnirudes 

» Reddening  index 

• Double  star  and  variability  flags 

The  user  may  specif}'  additional  words  of  output  to  be  chosen  from  those  avail- 
able in  the  Master  Catalog. 

2.2.2  Program  UPDATE 

Program  UPDATE  generates  the  Mission  Catalog  from  the  Master  Catalog.  The 
following  functions  are  performed  by  UPDATE: 

• Calculation  of  derived  parameters  requested  by  the  user 

• Output  of  the  Mission  Catalog  on  a sequential  file 
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• Printing  of  a summary  of  the  Mission  or  Master  Catalog  upon  re- 
quest 

• Providing  a framework  for  altering,  adding,  or  deleting  data  in  the 
Master  Catalog 

2.3  THE  RUN  CATALOG 

The  Run  Catalog  is  a presorted  (possibly  modified)  version  of  the  Mission  Cata- 
log. It  is  the  catalog  actually  accessed  by  the  mission’s  analytical  programs. 
Section  6 gives  a complete  description  of  the  Run  Catalog,  which  is  only  briefly 
described  in  this  section. 

2.3.1  Organization  and  Content  of  the  Run  Catalog 

The  Run  Catalog  may  be  generated  either  in  sequential  or  direct-access  format. 
It  contains  sufficient  data  control  records  such  that  programs  using  the  catalog 
may  be  run  without  additional  user  input  describing  the  Run  Catalog.  The  Run 
Catalog  is  complete  to  a user-specified  limiting  instrumental  magnitude,  not  to 
exceed  that  of  the  Mission  Catalog,  and  contains  the  following  data: 

• HD  number 

• Geocentric  inertial  coordinates  of  the  star's  unit  vector  at  the  user- 
specified  epoch 

• Up  to  four  additional  words  of  information  at  the  discretion  of  the 
user,  one  of  which  is  normally  the  instrumental  magnitude 

2.  3.  2 Program  CAT 

Program  CAT  generates  the  Run  Catalog  from  the  Mission  Catalog  ior  option- 
ally, from  the  Master  Catalog).  Functions  performed  by  CAT  are  as  follows: 

• Calculates  geocentric  inertial  coordinates  <XYZ)  from  right  ascen- 
sion and  declination  (if  necessary). 
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• Defines  overlapping  zones  that  collectively  cover  the  entire  sky. 

• Sorts  the  stars  of  the  input  catalog  into  subcatalogs,  one  sub-  . 
catalog  for  each  zone. 

• Outputs  the  subcatalogs  on  a sequential  or  direct-access  file. 

• Outputs  control  word  records  describing  the  Run  Catalog.  Pro- 
grams  using  the  Run  Catalog  obtain  all  the  information  they  need 
to  access  the  subcatalogs  from  these  control  word  records. 

• Provides  the  user  with  the  opportunity  to  alter  the  input  data  as 
desired. 

2.3.3  Run  Catalog  Manipulation 

The  Run  Catalog  is  normally  generated  by  program  CAT  on  a sequential  (tape) 
file.  It  is  transferred  to  a direct-access  disk  file  by  program  SWITCH.  If 
desired,  only  selected  subcatalogs  need  be  stored  on  disk.  Program  SWITCH 
allows  the  user  to  select  which  subcatalogs  to  store.  Programs  interface  with 
the  Run  Catalog  by  using  the  "access  module"  of  program  LOOKAT,  which  is 
described  in  Section  2.3.4. 

2.  3.  3. 1 Program  SWITCH 

The  functions  performed  by  program  SWITCH  are  as  follows: 

• Copies  the  Run  Catalog,  or  portions  of  it,  from  one  file  to  another. 

• Converts  the  Run  Catalog  from  sequential  format  to  direct-access, 
or  vice  versa. 

• Selects  specified  subcatalogs  for  copying  to  the  output  file. 

• Prints  a map  of  the  portions  of  the  celestial  sphere  covered  by  the 
selected  subcatalogs. 
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• Rewrites  the  control  word  records  of  the  Run  Catalog  to  reflect 
the  presence  or  absence  of  each  subcatalog  in  the  output  file. 

• Prints  the  contents  of  the  subcatalogs. 

2.  3. 3.  2 Selection  of  Subcatalogs  by  SWITCH 

Program  CAT  normally  produces  the  Run  Catalog  on  tape.  Those  portions  of 
the  Run  Catalog  which  are  needed  by  analytical  programs  are  then  copied  onto 
disk  storage.  Program  SWITCH  performs  this  function. 

If  it  is  inconvenient  to  determine  which  parts  of  the  sky  will  be  observed  by  the 
star  cameraisi,  or  if  disk  storage  is  plentiful,  the  user  can  avoid  having  to 
rerun  SWITCH  periodically  by  placing  the  entire  Run  Catalog  on  disk  using 
SWITCH.  CAT  can  also  generate  the  Run  Catalog  directly  onto  disk. 

The  user  may  wish  to  save  disk  space  by  using  SWITCH  to  store  only  portions 
of  the  Run  Catalog — namely,  those  portions  it  is  anticipated  will  be  used  in  the 
near  future.  This  technique  is  especially  useful  when  the  star  cameraiS)  will 
be  pointing  in  nearly  the  same  airection(s)  for  an  extended  period  of  time.  In 
that  case,  only  those  subcatalogs  which  might  fall  within  the  range  of  the  cam- 
era^) are  needed. 

2.  3. 3.  3 Interactive  Capability  in  SWITCH 

Program  SWITCH  can  be  run  interactively  on  the  IBM  S/360-S5  under  the  Time- 
sharing Option  iTSO),  in  the  foreground  mode.  TSO  output  is  confined  to  moni- 
toring information  reporting  on  the  progress  of  the  program.  Error  messages 
are  sent  to  the  TSO  terminal  if  conditions  within  the  program  reouire  an  abnor- 
mal termination. 

The  advantages  of  running  SWITCH  interactively  are  as  follows: 

• I:  can  be  run  in  the  foreground  mode,  thus  decreasing  turnaround 
rime. 
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• Internal  error  messages  allow  the  user  to  correct  errors  in  his 
NAMELIST  or  other  input  without  waiting  for  printed  output. 

Both  of  these  advantages  may  be  critical  when  an  operational  support  system  has 
to  reconfigure  the  Run  Catalog  quickly. 

2.3.4  Using  the  Run  Catalog — Program  LOOKAT 

Program  LOOKAT  is  a modularized  program  performing  several  related  func- 
tions. Its  basic  function  is  interfacing  the  Run  Catalog  with  analytical  programs. 
Secondary  functions  include  creating  various  plots  of  the  stars  found  in  portions 
of  the  sky  and  performing  statistical  surveys  over  sections  of  the  celestial 
sphere. 

Because  LOOKAT  has  been  modularized,  only  those  subroutines  needed  to  per- 
form a specific  task  have  to  be  linked  into  the  user  program. 

LOOKAT  contains  two  basic  modules  to  perform  these  duties.  The  Access 
Module  is  discussed  in  Section  2. 3.  4.1  and  the  Statistics  Module  is  discussed 
in  Section  2.  3. 4. 2. 

2.  3. 4. 1 The  Access  Module 

The  Access  Module  of  program  LOOKAT  is  designed  to  allow  interface  with 
the  Run  Catalog  with  a minimum  of  effort.  Basically,  a program  which  needs 
star  catalog  information  supplies  LOOKAT  with  a star  camera  optical  axis 
pointing  or  pointings.  LOOKAT  then  loads  the  relevant  subcatalog  into  calling 
sequence  arrays.  There  are  three  ways  to  specify  the  region  of  interest,  which 
will  be  described  below. 

Input  to  the  Access  Module  consists  of  the  Run  Catalog,  which  must  have  been 
loaded  onto  disk  in  direct-access  format,  and  calling  sequence  variables  which 
instruct  LOOKAT  to  load  specified  subcatalog(s)  into  arrays.  Ail  the  informa- 
tion about  the  Run  Catalog  which  LOOKAT  needs  is  available  in  the  control  rec- 
ords of  the  Run  Catalog.  A call  to  LOOKAT' s initialization  subroutine  at  the 
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start  of  the  program  causes  LOOKAT  to  read  these  records  and  initialize  appro- 
priate internal  arrays. 

Because  all  necessary  information  concerning  the  Run  Catalog  exists  within  it- 
self, the  user  program  need  only  give  LOOKAT  sufficient  information  to 
determine  which  subcatalogs  are  needed.  This  may  be  done  in  the  following 
three  ways: 

• First,  the  star  camera  optical  axis  pointing(s)  may  be  input. 
LOOKAT  then  produces  a "cap''  catalog  by  loading  into  core  the 
star  information  for  all  stars  within  a specified  angular  distance 
of  the  optical  axis. 

» Second,  LOOKAT  can  produce  a "band"  around  the  celestial  sphere 
corresponding  to  the  path  of  the  camera  optical  axis  through  the 
sky-  as  the  spacecraft  spins.  To  do  this,  the  spin  axis  pointing, 
and  the  angle  at  which  the  star  camera  is  mounted  relative  to  the 
spin  axis,  must  be  input. 

• Third,  LOOKAT  can  produce  a "wedge"  out  of  such  a band  by 
specifying  the  above  and,  in  addition,  specifying  a starting  (or 
central)  optical  axis  pointing  and  the  length  of  the  desired  "wedge." 

For  the  second  and  the  third  methods,  the  Access  Module  of  program  LOOKAT 
also  has  the  capability  of  sorting  the  stars  in  the  output  catalog  by  longitude. 
Stars  dimmer  than  a specified  limiting  magnitude  may  be  excluded  from  the 
output  catalog. 
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2.  3.4.2  The  Statistics  Module 

The  Statistics  Module  of  program  LOOKAT  provides  statistical  data  about,  and 
printer  plots  of,  a region  of  the  sky  covered  by  a user-specified  Core  Catalog. 
The  Statistics  Module  can  perform  the  following: 

• Call  Access  Module  subroutines  to  produce  a Core  Catalog  in  either 
the  cap,  band,  or  wedge  forms.  This  Core  Catalog  is  then  processed 
by  the  rest  of  the  Statistics  Module. 

• Select  stars  from  the  Core  Catalog  for  further  processing  on  the 
basis  of  one  of  the  star  data  words  being  within  user-specified 
bounds. 

• Compute  right  ascensions  and  declinations  of  Core  Catalog  stars. 

• List  the  Run  Catalog  data  control  record  parameters. 

• List  all  the  stars  in  user-specified  Run  Catalog  zone  subcatalogs. 

• ■ Sort  the  Core  Catalog  in  either  ascending  or  descending  order  of 

any  star  data  word. 

• List  any  user-specified  subset  of  Core  Catalog  stars  which  are  con- 
tiguous in  either  ascending  or  descending  order  of  any  star  data 
word. 

• Provide  a count  of  stars  in  the  Core  Catalog  which  fall  into  each 
user-defined  range  of  any  star  data  word,  and  produce  a histogram 
of  these  frequencies. 

• Produce  a printer  plot  of  the  Core  Catalog  stars. 

• Correlate  any  two  star  data  words  for  Core  Catalog  stars,  using 
either  a linear  or  quadratic  fit,  and  generate  a printer  pier  of  the 
data  and  the  resulting  fitted  curve. 
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2.4  PROGRAM  DESCRIPTION  FORMATS 

Each  of  the  programs  previously  discussed  in  this  section  is  fully  described  in 
one  of  the  later  sections  of  this  document.  The  descriptions  of  each  program 
adhere  to  the  following  format: 

• Program  requirements  and  interface  with  SKYMAP 

• Capabilities  and  logical  program  flow., 

a Mathematical  specifications 

• Baseline  diagram  and  unit  descriptions 

» Common  area  descriptions 

> Operating  guide 

2.4.1  Unit  Description  Format 

All  unit  descriptions  in  this  document  start  the  description  on  a new  page,  and 
all  pages  associated  with  a unit  contain  the  unit  name  in  the  upper  right-hand 
corner,  which  will  aid  in  frequent  reference  to  the  subroutine.  For  each  pro- 
gram described,  the  main  routine  is  described  first,  followed  by  the  subroutines 
in  alphabetical  order.  Unit  descriptions  that  appear  in  this  document  under  the 
appropriate  program  description  contain  the  following  information. 

DESCRIPTION:  A brief  statement  of  the  unit's  function  and  possibly  a short 
narrative  description  of  the  unit  flow  is  given. 

CALLING  SEQUENCE:  SUBROUTINE  OR  FUNCTION.  The  name  and  argument 
list,  if  any,  are  supplied  :o  indicate  usage  by  the  subprogram. 

COMMON  AREAS  REFERENCED:  The  names  of  the  COMMON  areas  referenced 
by  the  subprogram  are  listed  in  alphabetical  order.  The  COMMON  areas  are 
described  m the  appropriate  COMMON  area  description  section. 

EXTERNAL  REFERENCES:  All  references  to  subprograms  other  than 
Svstem  CSO  and  FORTRAN  library  routines  are  listed  in  alphabetical  order. 
CALLED  BY:  Units  that  access  this  subprogram  are  listed  in  alphabetical  oruer. 
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INPUT/OUTPUT  DATA  SETS:  If  this  heading  is  present,  a description  of  the 
type  of  input/output  (e.  g. , diagnostic  output  or  star  catalog  input)  is  given  along 
with  the  data  set  reference  numbers. 

ERROR  MESSAGES:  A brief  description  of  the  cause  of  the  error  and  the  mes- 
sage that  appears  are  given.  If  this  heading  is  not  present,  no  error  messages 
are  originated  by  the  subprogram.  More  details  concerning  the  cause  of  the 
error,  the  program  action  taken,  and  user  response  to  be  taken  are  given  in 
the  appropriate  programs'  User's  Manual  subsection. 

The  above  information  is  presented  on  the  first  page(5)  of  the  unit  description. 
The  succeeding  pages  of  the  description  list,  in  tabular  form,  ail  the  variables 
that  interface  with  the  unit  through  the  calling  sequence  or  COMMON  blocks. 

The  tables  contain  the  following  column  headings: 

• Name:  The  variable  names  are  listed  in  their  order  of  appearance 
in  the  calling  sequence.  Arrays  are  designated  by  their  maximum 
dimensions. 

• Symbol:  If  a symbol  has  been  associated  with  the  variable,  it  is 
listed  in  this  column. 

• I/O:  The  letter  I indicates  that  the  variable  must  be  known  under 
some  or  all  circumstances  before  calling  the  unit;  O indicates  that 
the  variable  may  have  been  modified  prior  :o  exiting  the  unit;  and 
I/O  indicates  both  conditions. 

• Tj'pe:  R^S  indicates  that  the  \ariable  is  an  i-b"te  floating-point 
number  and  R*4  indicates  a 4-bvte  floating-point  number.  I '4  indi- 
cates a 4-byte  integer  number  and  1*2,  a 2 -byte  integer  number. 

L*1  indicates  a 1 -byte  logical  variable.  (Frequently,  arrays  of 
these  variables  are  used  to  store  literal  information.! 
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• Interface:  The  letters  C.S.  indicate  calling  sequence  interface;  for 
other  variables,  the  name  of  the  COMMON  block  is  given. 

* Description:  The  variable  is  briefly  described. 

2.4.2  COMMON  Area  Description  Format 

All  COMMON  area  descriptions  in  this  document  start  the  description  on  a new 
page  and  all  pages  associated  with  a COMMON  area  contain  the  COMMON  name 
(e.g. , /CATCOM/)  in  the  upper  right-hand  corner.  COMMON  area  descriptions 
that  appear  in  this  document  under  the  appropriate  program  description  contain 
the  following  information: 

DESCRIPTION:  A brief  description  of  the  contents  of  the  COMMON  area  is 
given. 

FORM:  The  variables  appear  in  the  order  required  for  proper  use  of  the 

COMMON  area  li.e. , COMMON/name/list). 

* 

REFERENCED  BY:  The  names  of  subprograms  in  alphabetical  order  that 
reference  the  named  COMMON  area  are  given. 

VARIABLES:  The  COMMON  area  variables  are  in  tabular  form,  with  the 
following  headings: 

• Name:  Variable  names  are  listed  in  the  order  in  which  they  appear 
in  the  COMMON  area.  Arrays  are  designated  by  their  maximum 
dimensions. 

* Type:  indicates  that  the  '-ariable  is  an  3 -byte  floating-pom: 

number  and  Rx4  indicates  a 4-byte  floating-point  number,  i-4  indi- 
cates a 4 -byte  integer  number  and  1*2,  a 2 -byte  integer  number. 

L'i  indicates  a 1-byte  logical  variable. 

» Description:  The  variable  is  briefly  described. 
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2.4.3  NAMELIST  Description  Format 

All  NAMELIST  descriptions  in  this  document  start  the  description  on  a new  page 
and  all  pages  associated  with  a particular  NAMELIST  contain  the  NAMELIST 
name  fe.g. , &CATIN)  in  the  upper  right-hand  corner.  NAMELISTs  for  each 
program  are  presented  in  alphabetical  order.  NAMELIST  descriptions  that 
appear  in  this  document  under  the  appropriate  program  description  contain  in- 
formation under  the  following  column  headings  for  the  NAMELIST  variables-. 

» Name:  Variable  names  are  listed  in  the  order  in  which  they  appear 
in  the  NAMELIST.  Arrays  are  designated  by  their  maximum  di- 
mensions. 

• Type:  R*4  indicates  a 4 -byte  floating-point  number  and  1*4  indicates 
a 4 -byte  integer  number. 

• Default:  If  the  variable  is  set  in  BLOCK  DATA  or  a DATA  statement, 
its  default  value  is  given. 

• Description:  The  variable  is  briefly  described.  The  units  and  ac- 
ceptable limits  of  the  variable  are  also  given. 
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SECTION  3 - MASTER  CATALOG  DATA 


The  Master  Catalog  is  the  data  base  for  the  SKYMAP  system.  It  contains 
540  bytes  of  data  for  each  of  approximately  255,000  stars. 1 The  Master  Cata- 
log contains  all  known  stars  with  either  B or  V magnitude  brighter  than  9.0. 

This  section  describes  the  types  of  data  included  in  the  Master  Catalog,  the 
source  for  the  data,  and  if  derived,  the  procedure  used  in  the  derivation.  Sec- 
tion 4 contains  the  details  of  the  Master  Catalog  data  organization. 

3.  1 STARS  INCLUDED  IN  THE  MASTER  CATALOG 

The  basis  for  the  Master  Catalog  is  the  Henry  Draper  (HD)  catalog  (Refer- 
ence 3).  As  the  HD  is  nearly  complete  to  9.0  visual  magnitude,  most  stars 
bright  enough  to  be  included  in  the  Master  Catalog  are  HD  stars.  Additional 
stars  were  added  from  Blanco  (Reference  8),  the  Smithsonian  Astrophysical 
Observatory  (SAO)  star  catalog  (Reference  4),  the  AC-K-3  star  catalog  (Refer- 
ence 39),  the  Catalog  of  Visual  Double  Stars  (Reference  33),  and  Kukarkin 
(Reference  9). 

To  determine  which  stars  from  the  above  references  to  include  in  the  Master 
Catalog,  the  B and  V magnitudes  of  each  star  were  compared  against  a limiting 
value  of  9.  0 plus  an  allowance  for  the  anticipated  error  in  the  star  magnitude. 
The  value  for  this  anticipated  error  depended  upon  the  method  by  which  the  B 
and  V magnitudes  were  obtained. 

For  stars  with  measurements  in  the  UBV  system,  the  error  allowance  was 
taken  to  be  0.  1 magnitude.  Stars  for  which  only  photovisual  and  photographic 
magnitudes  exist  had  these  converted  to  B and  V using  the  procedures  given  in 
Section  3.4.4.  Error  allowances  for  these  stars  varied  according  to  the  pro- 
cedure used,  which  in  turn  depended  on  whether  one  or  both  of  the  photographic 


'''The  number  of  stars  in  the  Master  Catalog  will  vary  slightly  as  additions, 
corrections,  and  deletions  are  made  to  the  data  base. 
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and  photovisual  magnitudes  existed.  A discussion  of  this  methodology  is  given 
in  Section  3.4.2  (see  Table  3-8). 

3.2  STAR  NUMBERS  AND  CROSS-REFERENCES 

3.2.1  SKY  MAP  Number 

A new  numbering  system  has  been  introduced  for  all  stars  in  the  SKYMAP 
catalog.  The  system  is  open  ended  so  that  stars  .may  be  added  to  the  catalog 
without  renumbering  the  existing  stars.  Each  SKYMAP  star  was  assigned  a 
number  of  the  form  XXYYZZZZ,  where  XX  is  the  hours  of  right  ascension, 
epoch  2000.0;  YY  is  the  minutes  of  right  ascension,  epoch  2000.0;  and  ZZ  is 
a running  index,  starting  at  0001.  The  advantage  to  this  numbering  system  is 
that  all  SKYMAP  stars  have  a SKYMAP  number,  whereas  only  a fraction  of  them 
have  HD  or  SAO  numbers. 

3.2.2  HD  Number 

The  star  number  from  the  HD  catalog  (Reference  3)  is  the  basic  number  assigned 
to  each  Master  Catalog  star.  For  those  few  stars  (approximately  1 percent)  not 
having  an  HD  number,  numbers  were  assigned  sequentially  beginning  at  500001. 

3.2.3  Durchmusterung  (DM)  Number 

The  HD  catalog  also  contains  star  numbers  from  the  extensive  Durchmusterung 
catalogs — the  Bonner  Durchmusterung  (BD)  (References  10  and  11),  the  Cordoba 
Durchmusterung  (CD)  (References  12  and  13),  and  the  Cape  Photographic 
Durchmusterung  (CPD)  (Reference  14). 

Collectively,  these  catalogs  cover  the  entire  sky,  with  the  BD  extending  from 
the  North  Pole  to  declination  -23  degrees,  the  CD  ranging  from  declination 
-23  degrees  to  -62  degrees,  and  the  CPD  covering  the  remainder  of  the  sky. 

The  Master  Catalog  contains  BD  numbers  where  available,  then  CD  numbers, 
and  CPD  numbers  if  no  others  exist. 
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The  Durclunusterung  number  consists  of  a zone  number  referring  to  the  declina- 
tion of  the  star  at  the  epoch  of  the  Durchmusterung  (1855.  0),  and  a sequential 
number  within  that  zone.  Therefore,  star  -2°  317  is  the  317th  star  between 
declinations  -2  degrees  and  -3  degrees.  For  ease  in  computation,  these  num- 
bers have  been  converted  into  a single  integer,  defined  as 

(100000  (Z  + 100)  - N,  for  Z positive 

D = ' (3-1'. 

1 100000  (Z  + 99)  - N,  for  Z negative 

where  D = converted  Durchmusterung  number 
Z = zone  number 
N = sequential  number 

The  difference  in  the  formula  for  positive  and  negative  Z is  to  allow  for  the  ex- 
istence of  both  a -0  degree  zone  (stars  with  declinations  between  0 and  -1  de- 
grees) and  a -0  degree  zone  (stars  with  declinations  between  0 and  -1  degrees). 

3.2.4  SAP  Number 

The  SAO  number  was  obtained  from  the  SAO  catalog  (Reference  4).  Approxi- 
mately 93  percent  of  the  Master  Catalog  stars  have  SAO  numbers. 

3.2.5  Miscellaneous  Identifiers 

Several  other  star  names  and  numbers  have  been  included  in  the  Master  Catalog 
to  permit  easy  cross-reference  to  printed  star  catalogs.  They  are 

« The  HR  number  from  the  Yale  Catalog  of  Bright  Stars  lYBSC) 
.Reference  15).  Only  about  9100  of  the  brightest  stars  have  HR 
numbers. 

© The  Flamsteed  name,  obtained  from  the  YBSC  (for  example,  alpha 
Orionis).  Only  about  1000  bright  stars  have  Flamsteed  names. 
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• The  number  from  the  Wilson  Catalog  of  Radial  Velocities  (Refer- 
ence 16). 

• The  number  from  the  Aitken  Double  Star  Catalog  (ADS)  (Refer- 
ence 17). 

• The  sequence  number  from  Kukarkin's  General  Catalog  of  Variable 
Stars  (Reference  9). 

• The  star  name  from  the  General  Catalog  of  Variable  Stars  (for 
example,  BU  Camelopardi). 

3.2.6  Star  Number  Cross-Reference  Tables 

Because  the  various  source  catalogs  have  different  star  numbering  systems,  a 
cross-reference  of  the  HD  number,  the  SAO  number,  and  the  DM  number  was 
created.  Right  ascension  and  declination,  epoch  2000.0,  and  visual  magnitude 
are  also  cross-referenced  for  each  star.  The  cross-reference  was  obtained  by 
combining  data  from  the  SAO  catalog  (Reference  4),  which  gives  the  SAO  and 
DM  number,  and  the  HD  catalog  (Reference  3),  which  gives  the  HD  and  DM 
number. 

To  create  the  first  approximation  to  the  cross-reference  index,  the  SAO  and 
the  HD  catalogs  were  sorted  in  order  of  DM  number  and  then  merged.  The 
HD  position,  precessed  to  1950.0,  was  checked  against  the  SAO  position  for 
all  stars  that  were  matched  with  one  another  by  the  above  procedure.  Checks 
were  also  performed  on  the  photovisual  and  photographic  magnitudes  and  the 
spectral  types.  Tolerances  of  120  arc-seconds  were  applied  in  right  ascension 
and  declination,  1.0  magnitude  in  magnitude,  and  0 in  spectral  type.  All  stars 
failing  one  or  more  checks  were  examined  manually,  and  the  only  entries 
accepted  were  those  for  which  the  discrepancy  noted  above  could  be  explained 
(e.g. , by  an  inadvertent  inversion  of  magnitudes  in  one  of  the  source  catalogs) , 
and  for  which  the  other  parameters  passed  the  stricter  tests  of  tolerances — 

30  arc-seconds  in  right  ascension  and  declination  and  0.5  magnitude  in 
magnitude. 


All  SAO  stars  not  matched  with  HD  stars  by  this  method  were  then  tested 
against  all  HD  stars  in  an  attempt  to  add  entries  to  the  cross-reference  table. 
Entries  were  matched  on  the  basis  of  position,  magnitude,  and  spectral  type. 
The  tolerances  were  approximately  30  arc-seconds  in  right  ascension  and  dec- 
lination, 1.0  magnitude  in  magnitude,  and  0 in  spectral  type.  Each  case  was 
reviewed  manually  to  remove  spurious  matches  among  members  of  multiple 
star  systems.  The  resultant  cross-reference  table  has  over  320,000  entries, 
with  each  entry  containing  at  least  two  of  the  three  star  numbers  considered. 

3.3  POSITIONAL  DATA 

Catalog  star  positions  are  given  at  the  standard  time  (epoch),  2000.0.  To 
determine  a star's  position  at  an  epoch  different  from  the  catalog  epoch,  cor- 
rections must  be  made  for  precession  of  the  Earth's  axis  and  proper  motion  of 
the  star  across  the  sky.  The  Master  Catalog  provides  this  information. 

3.3.1  Position  at  a Standard  Epoch 

The  SAO  catalog  (Reference  4)  is  the  primary  source  of  star  positions  because 
it  contains  accurate  data  for  a large  number  of  stars.  For  those  stars  not  in 
the  SAO  catalog,  positions  are  taken  (in  order  of  preference)  from  the  follow- 
ing: the  AGK-3  catalog  (Reference  39),  the  HD  catalog  (Reference  3),  the  HD 
Extension  (Reference  40),  Mermilliod  (Reference  19),  or  Blanco  (Reference  8). 
All  positions  are  precessed  from  the  catalog  epoch  to  epoch  2000.0  using  the 
precession  correction  noted  in  Section  3.3.3  and  the  proper  motion  (if  known) 
discussed  in  Section  3.3.2. 

To  determine  whether  or  not  to  substitute  AGK-3  data  for  the  SAO  and  HD  posi- 
tions already  in  SKY2.L\P,  the  accuracy  and  reliability  of  the  AGK-3  catalog 
■was  evaluated  and  no  evidence  was  found  to  dispute  the  accuracy  estimates  con- 
tained in  either  the  SAO  or  AGK-3  catalogs.  It  is  therefore  concluded  that  the 
AGK-3  catalog  is  probably  slightly  more  accurate  than  the  SAO.  However,  a 
small  number  of  large  differences  in  AGK-3  and  SAO  positions  and  proper 
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motions  were  found  which  are  probably  due  to  errors  in  the  AGK-3  catalog. 

The  accuracy  of  SKYMAP  star  positions  taken  from  the  SAO  is  adequate  for 
analysis  of  star  sensor  data  because  the  errors  are  typically  less  than  1 arc- 
second.  Therefore,  AGK-3  data,  although  slightly  more  accurate,  is  not  sub- 
stituted for  SAO  data.  The  accuracy  of  SKYMAP  star  positions  taken  from 
non-SAO  sources  is  very  poor,  with  typical  errors  of  about  35  arc-seconds. 
Therefore,  AGK-3  data  was  substituted  for  this  data  to  improve  accuracies, 
accepting  the  small  number  of  errors  so  introduced.  Reference  39  is  a detailed 
report  of  this  procedure. 

Positions  are  reported  as  right  ascension  and  declination  at  epoch  1950.0  and 
as  a unit  vector  in  a rectilinear  coordinate  system  defined  by 

X = cos  6 cos  OL 

Y = cos  6 sin  a (3-2) 

Z = sin  6 

where  a is  right  ascension,  6 is  declination,  and  (X,  Y,  Z)  is  the  unit  vector. 
The  (X,  Y,  Z)  coordinate  system  definition  corresponds  to  the  projection  of  the 
Earth's  North  Pole  onto  the  celestial  sphere  as  the  Z-axis,  and  the  vernal 
equinox  as  the  X-axis,  at  epoch  2000.0.  The  Y-axis  completes  a right-handed 

/N  /N  /\ 

orthonormal  coordinate  system  such  that  Z = X x Y.  Neglecting  the  effect  of 
heliocentric  parallax  (always  less  than  1 arc-second),  this  coordinate  system 
is  identical  to  the  Geocentric  Inertial  frame  (G.I.  frame)  used  repeatedly  for 
attitude  determination  functions. 

3.3.2  Proper  Motion 

The  SAO  proper  motion  in  right  ascension  and  in  declination  is  reported  in  the 
Master  Catalog  for  all  SAO  stars.  Non-SAO  stars  have  proper  motions  from 
the  AGK-3  catalog  (Reference  39),  or  have  no  observed  proper  motion.  For 
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lengths  of  time  of  up  to  several  hundreds  of  years , proper  motion  corrections 
can  be  applied  linearly,  as  follows: 


a.  = a,  + m At 
I -J  o: 

6I  = 6J  ^ "6at 


(3-3) 


where  (0^,  6^)  = right  ascension  and  declination  at  epoch  I 

(a  , 6 ) = right  ascension  and  declination  at  standard  catalog  epoch  J 

( u > Hg)  = proper  motion  per  year  in  right  ascension  and  declination 

At  = the  difference  in  years  and  fraction  of  a year  between 
epoch  I and  epoch  J 

3.3. 3 Precession 

Because  the  Earth's  spin  axis  precesses  with  a period  of  26,000  years,  star 
positions  in  the  quasi-G.I.  system  defined  above  change  slowly.  This  effect, 
known  simply  as  ’’precession, ” was  computed  for  each  star  using  the  following 
equations: 


(XT  Y'  T)  = 


cos  £ cos  6 cos  Q 
-sin  £ sin  Q 

cos  £ cos  9 sin  Q 
- sin  £ cos  Q 

[cos  £ sin  0 


-sin  £ cos  9 cos  Q -sin  0 cos  Q 

- cos  C sin  Q 

-sin  £ cos  9 sin  Q -sin  8 sin  Q 

- cos  £ cos  Q 


-sin  £ sin  0 


cos  9 


(3-1) 


where  C = 2305'.’268 

8 = 2003’.'787 
Q = 2306V060 

X,  Y,  Z = the  star's  geocentric  inertial  unit  vector  at  the  initial  epoch 
X',  Y\  Z'  = the  star’s  geocentric  inertial  unit  vector  100  years  later 
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The  precession  in  right  ascension  (P^)  and  declination  (P^)  per  year  is  ob- 
tained by  converting  both  unit  vectors  to  right  ascension  (a)  and  declination 
(6)  by  using 


a = tan"1(Y/X) 

6 = sin"1(Z) 
a'  = tan"1(Y'/X’) 
6'  = sin"1(Z’) 


and  then  differencing  the  results 


v P = a'  - a 

a 

P.  = 6'  - 6 

o 

The  precession  correction,  like  proper  motion,  may  be  applied  linearly  over 
periods  of  several  hundreds  of  years  by  substituting  P^  and  Pg  for  ^ and 
, respectively,  in  Equation  (3-3). 

3.3.4  Accuracy  of  Star  Positions 

The  accuracy  of  a star  position  at  a given  epoch  (e.g. , 1975.0)  depends  upon 
the  accuracy  of  the  catalog  position  at  the  standard  epoch  and  of  the  corrections 
used  to  convert  position  to  the  desired  epoch.  The  Master  Catalog  standard 
epoch  is  2000.0.  For  SAO  stars,  the  error  in  catalog  right  ascension  and 
declination  at  epoch  2000.0  is  usually  less  than  2 arc-seconds.  AGK-3  stars 
have  equally  accurate  positions  (see  Reference  41).  Precession  corrections 
are  accurate  to  better  than  0.001  arc-second  per  year.  Stars  not  in  the  SAO 
or  AGK-3  have  positional  errors  of  up  to  2 arc-minutes  at  epoch  2000.0. 
Because  no  proper  motions  exist  for  these  stars,  additional  errors  build  up 
at  a maximum  rate  of  about  1 arc- minute  per  100  years  for  epochs  after  2000.0. 
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However,  most  stars  have  proper  motions  an  order  of  magnitude  smaller  than 
this.  Conversion  to  earlier  epochs  decreases  the  error  slightly  up  to  about 
1900.0,  because  proper  motion  errors  resulting  from  the  conversion  of  HD 
positions  to  epoch  2000.0  disappear.  They  begin  to  build  up  again  at  the 
stated  rate  for  epochs  prior  to  1900.0. 

3.4  SPECTRAL  TYPE  AND  MAGNITUDE  DATA 

Star  sensors  will  detect  stars  that  are  "sufficiently''  bright  on  an  "instrumental 
scale,”  where  "sufficiently"  and  "instrumental  scale"  vary  from  sensor  to 
sensor.  Star  catalogs  report  brightnesses  as  magnitudes  defined  by  the  loga- 
rithmic function 


m = -2.5  log1Q  G + C 


(3-5) 


where  m = star  magnitude 
G = star  brightness 

C = constant  defined  arbitrarily  at  the  time  the  magnitude  system  is 
created 

Therefore,  higher  magnitudes  represent  dimmer  stars. 

Because  detector  responses  are  based  on  the  star  brightness  on  an  instrumen- 
tal scale,  the  user  may  wish  to  compute  the  instrumental  magnitude  of  catalog 
stars , defined  by 


m'  = -2.5  log1Q 


- I(X)]  P(A)  dAj  + c 


(3-6) 


where  X = wavelength 

E(A)  = star  energy  flux  as  a function  of  wavelength  at  some  standard 
distance 
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r = distance  from  the  star  to  the  Earth,  in  units  of  the  standard 
distance 

1(A)  = interstellar  absorption  function  as  a function  of  wavelength,  and 
is  defined  as  the  fraction  of  light  of  wavelength  A absorbed  be- 
tween the  star  and  the  Earth 

P(\)  = instrumental  response  as  a function  of  wavelength,  and  is  defined 
as  the  fraction  of  light  incident  on  the  sensor  that  produces  an 
output  signal,  normalized  to  1.  0 at  the  wavelength  of  maximum 
response 

P(A)  is  independent  of  which  star  is  being  observed,  provided  that  the  star  is 
not  so  bright  that  it  saturates  the  sensor.  Consequently,  it  is  a function  of  the 
detector  used  and  does  not  appear  in  the  Master  Catalog.  The  constant,  C , 
in  Equation  (3-6)  is  defined  specifically  for  each  system,  and  is  discussed  in 
Section  3.4.2. 

The  interstellar  absorption  function,  1(A)  , can  be  deduced  from  the  "interstellar 
absorption"  discussed  in  Section  3.5. 

The  absolute  stellar  energy  distribution,  E(A)  , is  given  roughly  at  all  wave- 
lengths by  the  spectral  type,  discussed  in  Section  3.4.1.  More  precise  but  less 

2 

comprehensive  information  on  the  apparent  stellar  energy  distribution,  E(A)/r  , 
is  given  by  standard  magnitudes,  as  discussed  in  Section  3.4.2. 

The  following  quantities,  available  in  the  Master  Catalog  for  each  star,  must  be 
used  to  deduce  instrumental  magnitudes: 

• Spectral  class,  luminosity  class,  and  peculiarity  code,  collectively 
known  as  spectral  type,  either  observed  or  converted  from  other 
variables 

• Standard  UBV  magnitudes  either  observed  or  converted  from  other 
variables 

• An  interstellar  absorption  index  as  derived  according  to  the  proce- 
dures specified  in  Section  3.  5 
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3.4.1  Spectral  Type  Data 


The  standard  spectral  type  of  the  Master  Catalog  is  the  MK  (Reference  7) 
spectral  type,  consisting  of  a spectral  class,  luminosity  class,  and  peculiarity 
code.  The  spectral  class  is  essentially  a measure  of  stellar  temperature;  the 
luminosity  class,  of  surface  gravity;  and  the  peculiarity  code,  of  chemical 
composition,  speed  of  rotation,  and/or  existence  of  an  extended  atmosphere. 
Collectively,  these  give  an  approximation  to  the  absolute  spectral  energy  dis- 
tribution of  the  star.  This  approximation,  however,  becomes  successively  less 
accurate  as  one  progresses  towards  wavelengths  shorter  than  4000  A where  the 
effects  of  variables  other  than  those  measured  by  spectral  type  become  impor- 
tant. 


MK  spectral  types  were  obtained  from  Jaschek  (Reference  18)  or,  if  not  avail- 
able there,  from  Blanco  (Reference  8)  and  Mermilliod  (Reference  19).  Jaschek's 
catalog  is  a compendium  of  results  from  other  observers  and  therefore  some- 
times contains  more  than  one  entry  per  star.  Where  different  spectral  types 
are  listed  for  the  same  star,  the  one  given  most  frequently  has  been  adopted. 

If  two  or  more  were  given  with  equal  frequency,  the  first  one  listed  was  used. 

A similar  procedure  was  followed  for  Blanco's  and  Mermilliod' s catalogs. 

Where  no  observed  MK  spectral  type  existed,  the  HD  spectral  class,  as  re- 
ported in  the  HD,  SAO,  or  AGK-3  catalogs,  was  converted  to  an  MK  spectral 
type.  The  conversion  was  performed  by  obtaining  tables  of  frequency  of 
occurrence  of  MK  spectral  class,  luminosity  class,  and  peculiarity  code  for 
each  HD  spectral  class,  based  on  data  for  stars  which  had  both  HD  and  MK 
spectral  types.  The  most  frequently  occurring  values  were  adopted  as  the 
probable  MK  spectral  type  corresponding  to  the  HD  spectral  class.  Table  3-1 
gives  the  result  of  this  correlation.  The  converted  peculiarity  code  is  always 
taken  to  be  zero  (no  peculiarities  noted).  The  typical  spread  in  MK  spectral 
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Table  3-1.  SKYMAP  Equivalent  Spectral  Types  of 
HD  Spectral  Classes 


HD  SPECTRAL 
CLASS 

SKYMAP  SPECTRAL  TYPE 

NUMBER  OF 
DATA  POINTS 

SPECTRAL 

CLASS 

LUMINOSITY 

CLASS 

Oa 

B1* 

- 

2 

Ob 

BO* 

- "v 

1 

Of 

09.5 

- 

24 

BO 

80.5 

II 

293 

B1 

81 

hi 

70 

B2 

81 

IV 

267 

B3 

83 

V + 

721 

B5 

B5 

V + 

606 

B8 

B8 

V + 

630 

B9 

B9 

V + 

849 

B 

B1 

- 

233 

AO 

AO 

V + 

2011 

A2 

A2 

V + 

940 

A3 

A3 

V + 

416 

A5 

A7 

V + 

381 

A 

AO 

V + 

151 

FO 

FO 

V 

612 

F2 

F2 

V + 

382 

F5 

F5 

V + 

845 

F8 

F8 

V + 

651 

F 

FO* 

- 

18 

GO 

GO 

V ♦ 

1047 

G5 

G5 

IV 

1658 

G 

GO 

V + 

51 

KO 

KO 

III  + 

2917 

K2 

K2 

III  + 

750 

K5 

K5 

III  + 

663 

K 

K1 

III 

30 

Ma 

M2 

III  + 

328 

Mb 

M4 

111  + 

136 

Me 

M6* 

til  + 

15 

Md 

M5* 

III  + 

16 

♦MEANS  THE  LUMINOSITY  CLASS  NOTED  WAS  SHARED  BY  OVER  HALF  THE  SAMPLE  STARS. 
•MEANS  THE  SPECTRAL  CLASS  CONVERSION  IS  VERY  UNCERTAIN  DUE  TO  SCARCITY  OF  DATA 
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class  for  a given  HD  spectral  class  is  about  two- tenths  of  one  class. 1 Results 
of  a similar  study  of  SAO  and  AGK-3  spectral  types  produced  identical  results 
except  for  M stars  (see  Table  3-2). 

A similar  study  has  been  performed  by  the  University  of  Michigan  (Reference  20) 
based  on  their  re-observation  of  all  HD  stars  within  approximately  37  degrees 
of  the  South  Celestial  Pole  and  with  right  ascension  between  0 and  180  degrees. 
Their  results  tend  to  confirm  those  in  Table  3-1."  The  Michigan  study  will  be 
extended  to  cover  the  entire  sky  during  the  next  several  years.  When  complete, 
the  results  can  be  added  to  the  Master  Catalog,  providing  complete  and  uniform 
spectral  classes  for  nearly  all  Master  Catalog  stars. 

3.4.2  Magnitude  Data 

The  standard  magnitude  system  of  the  Master  Catalog  is  the  UBV  system  of 
Johnson  (Reference  5).  Figure  3-1  shows  the  spectral  response  curves  for 
these  magnitudes  based  on  data  from  Reference  21. 

The  effective  wavelengths  of  the  U,  B,  and  V magnitudes  are  approximately 
3500  A,  4400  A and  5500  A,  respectively.  Most  star  sensors  in  use  are  sensi- 
tive to  wavelengths  somewhere  between  these  ranges.  Occasionally,  a sensor 

o 

responds  to  shorter  wavelengths  down  to  about  2100  A (e.g. , the  HEAO-A 
Experiment  A-l  slit  star  sensor),  for  which  no  standard  magnitudes  exist. 

Observed  UBV  data  was  primarily  obtained  from  the  compilations  of  Mermilliod 
(Reference  19)  and  secondarily  from  Blanco  (Reference  8).  Errors  in  measure- 
ment typically  are  0.  02  magnitude. 

Whenever  the  Mermilliod  catalog  had  more  than  one  entry  per  star,  the  entries 
were  averaged.  The  Blanco  catalog  also  contained  multiple  entries  for  some 
stars.  A study  was  performed  paralleling  that  of  Reference  22  to  assess  the 


One  spectral  class  is  a whole  "letter"  difference,  e.  g. , the  difference  between 
F5  and  G5.  A tenth  of  a spectral  class  is  the  difference,  e.  g. , between  G5 
and  G6. 
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Table  3-2.  SKYMAP  Equivalent  Spectral  Types  of 
SAO  Spectral  Class 


SKYMAP  SPECTRAL  TYPE 

SAO  SPECTRAL 
CLASS 

NUMBER  OF 
DATA  POINTS 

SPECTRAL 

CLASS 

LUMINOSITY 
CLASS  . 

MO 

M2 

Ill  + 

41 1 

Ml 

M3* 

- 

5 

M2 

M3* 

- 

7 

M3 

M4 

Ill  + 

22 

M4 

M4 

- 

5 

+MEANS  THE  LUMINOSITY  CLASS  NOTED  WAS  SHARED  SY  OVER  HALF 
THE  SAMPLE  STARS 

♦MEANS  THE  SPECTRAL  CLASS  CONVERSION  IS  VERY  UNCERTAIN  DUE 
TO  SCARCITY  OF  DATA. 
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Figure  3-1.  Relative  Special  Response  Curves  for  U,  B,  and  V Magnitude 


ORIGiNAL  FAGE  !S 
OF  POOR  QUALITY 


reliability  of  each  observer  relative  to  the  mean  value  of  all  observers.  Mean 
errors  were  found  to  be  0.  016  magnitude  in  V,  0.  Oil  magnitude  in  the  differ- 
ence B-V,  and  0.  024  magnitude  in  the  difference  U-B.  Observers  having  mean 
errors  exceeding  0.  03,  0.  02,  and  0.  05  magnitudes  for  V,  B-V,  and  U-B,  re- 
spectively, were  deemed  to  be  less  accurate  than  the  norm,  and  their  obser- 
vations were  given  half  weight  in  the  subsequent  averaging.  A few  observers 
who  would  have  been  down-weighted  on  the  basis  of  this  test  were  still  accorded 
full  weight  if  the  results  were  based  on  fewer  than  10  comparisons  with  other 
observers,  or  if  the  exclusion  of  a single  data  point  brought  the  observer's 
mean  error  below  the  stated  tolerances.  The  Master  Catalog  entry  for  Blanco 
magnitudes  is  a weighted  average  of  all  observations  for  the  star.  Each  obser- 
vation was  given  unit  weight  except  those  made  by  observers  whose  Blanco  ref- 
erence number  is  listed  in  Table  3-3.  These  were  given  a weight  of  0.5. 

Several  highly  discordant  results  were  found  between  observers  of  the  same 
star  in  the  Blanco  catalog.  Whenever  an  individual  observation  deviated  by 
more  than  0. 1 magnitude  from  the  mean  for  that  star,  and  when  all  other  ob- 
servations for  the  star  agreed  to  within  0. 1 magnitude,  the  deviant  observation 
was  deleted  from  consideration  (given  zero  weight).  Table  3-4  lists  the  ob- 
servations which  were  deleted  in  their  entirety  because  all  data  entries  were 
discordant.  Table  3-5  lists  those  for  which  portions  of  the  observation  were 
deleted. 

For  stars  for  which  U magnitude  data  was  not  available,  a conversion  of  other 
data  to  a U magnitude  was  performed  (see  Section  3.5).  If  B and  V magnitudes 
were  not  available,  they  were  derived  from  the  HD,  SAO,  or  AGK-3  photo- 
graphic (ptg)  and  photovisual  (ptv)  magnitudes.  The  conversion  equations  were 
determined  by  a correlation  of  observed  B and  V magnitudes  with  ptg-ptv 
magnitudes  for  those  stars  having  both  types  of  magnitudes  and  also  a spectral 
type. 
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Table  3-3.  Blanco  (Reference  8)  Observers  Assigned  Half  Weight 


OBSERVATION 

- 

V 

B-V 

U-B 

BLANCO 

18 

18 

18 

OBSERVER 

70 

93 

REFERENCE 

192 

211 

NUMBERS 

212 

218 

238 

262 
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Table  3-4.  Blanco  Data  Points  Deleted  in  Their  Entirety 


BLANCO 

STAR 

CATALOG 

NUMBER 

BLANCO 

OBSERVER 

REFERENCE 

NUMBER 

508 

197 

1771 

12 

1771 

212 

3039 

405 

4085 

127 

4262 

122 

4432 

415 

5237 

197 

8270 

355 

’ 8908 

44 

9336 

104 

9336 

. 355 

9854 

18 

9854 

34 

12536 

310 

13272 

378 

14282 

18 

14520 

34 

14784 

18 

14784 

34 

16750 

122 

18764 

84 

18765 

84 

18765 

211 

19186 

363 
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Table  3-5.  Blanco  Data  Points  Partially  Deleted  (1  of  2) 


BLANCO 

STAR 

CATALOG 

NUMBER 

DATA 

DELETED 

BLANCO 

OBSERVER 

REFERENCE 

NUMBER 

283 

U-B 

320 

283 

U-B 

362 

484 

V 

3 

601 

B-V 

353 

1161 

B-V 

75 

1228 

c 

1 

00 

378 

1320 

V 

197 

2226 

V 

355 

2341 

B-V 

373 

2385 

V 

373 

2385 

U B 

373 

2444 

V 

83 

2444 

U-B 

373 

2449 

V 

83 

2449 

U-B 

83 

2530 

V 

10 

2596 

V 

65 

2596 

V 

84 

3479 

CD 

1 

< 

378 

3479 

B-V 

379 

3847 

c 

1 

00 

48 

4127 

U-B 

116 

4265 

V 

121 

4265 

V 

127 

4330 

V 

212 

4632 

U-B 

3 

4643 

V 

127 

4643 

V 

355 

5016 

V 

122 

5384 

V 

78 

5395 

U-B 

34 

5513 

U-B 

60 

BLANCO 

STAR 

CATALOG 

NUMBER 

DATA 

DELETED 

BLANCO 

OBSERVER 

REFERENCE 

NUMBER 

5523 

V 

11 

5526 

B-V 

234 

5706*' 

V 

4 

5832 

V 

223 

6364 

V 

415 

6967 

V 

378 

7160 

V 

122 

8401 

U-B 

18 

8996 

c 

1 

00 

18 

8996 

U-B 

34 

9555 

V 

3 

9669 

U-B 

18 

10182 

B-V 

122 

10413 

V 

33 

10414 

U-B 

75 

10675 

U-B 

422 

11825 

V 

122 

12102 

B-V 

122 

12969 

B-V 

251 

13042 

V 

34 

13275 

U-B 

67 

13275 

U-B 

362 

13542 

U-B 

75 

14217 

V 

362 

14284 

B-V 

18 

15299 

V 

212 

15383 

U-B 

79 

15383 

U-B 

88 

15842 

V 

197 

16324 

U-B 

296 

16885 

V 

197 

17026 

U-B 

79 
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Table  3-5.  Blanco  Data  Points  Partially  Deleted  (2  of  2) 


BLANCO 

STAR 

NUMBER 

DATA 

DELETED 

BLANCO 

OBSERVER 

REFERENCE 

NUMBER 

17351 

V 

192 

17597 

V 

119 

17732 

V 

65 

18081 

V 

378 

18734 

U-B 

79 

18909 

B-V 

25 

18909  j 

B-V 

79 

18909 

U-B 

79 

18910 

B-V 

12 

BLANCO 

STAR 

NUMBER 

DATA 

DELETED 

BLANCO 

OBSERVER 

REFERENCE 

NUMBER 

18910 

> 

1 

CO 

25 

19011 

U-B 

34 

19399 

U-B 

79 

19726 

B-V 

120 

19726 

c 

1 

CD 

120 

19855 

B-V 

251 

19937 

B-V 

68 

20036 

B-V 

121 

21650 

V 

212 

3-20 


ORIGINAL  PAGE 
Of  POOR  QUALITY 


A magnitude-dependent  correction  factor  was  computed  by  averaging  the  quantity 
(V  - ptv)  for  stars  having  both.  The  averaging  was  performed  in  V magnitude 
bins  0.  5 magnitude  in  width  and  a smooth  curve  fit  through  the  results  (see 
Figure  3-2).  A similar  procedure  was  followed  for  (B  - ptg)  ; the  results  are 
given  in  Figure  3-3.  The  correction  factors  are  given  by 


c = -0.24  +0.03  V 
c9  = -0.161  +0.0246  B 


(3-7) 


This  set  of  stars  was  then  divided  into  subsets  based  upon  spectral  class  as 

shown  in  Table  3-6.  Linear  least  squares  correlations  of  (ptg  + c ) to  B 

z 

and  V,  (ptv  + c ) to  B and  V,  and  both  (ptg  + c ) and  (ptv  + c ) to  B 
and  V were  computed;  however,  it  was  found  that  the  simpler  relations  given 
below  resulted  in  correlations  just  as  accurate. 

For  those  stars  having  both  ptv  and  ptg  observed, 


V = ptv  + a^  + c^ 
B = ptg  + a2  + c2 


For  those  stars  having  only  ptv  observed, 

V = ptv  + a^  + c^ 
B = V + (B  - V)* 


(3-8) 


(3-9) 
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Figure  3-2.  Correction  to  HD  Photovisual  Magnitude 


Figure  3-3.  Correction  to  HD  Photographic  Magnitude 
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Table  3-6.  Subsets  of  Spectral  Class  Used  for  Magnitude  Conversion 


CLASS  NUMBER 

RANGE  OF  MK  SPECTRAL  CLASS 

1 

00—09 5 

2 

B0-B3 

3 

B3.5-87 

4 

B7  5-89.5 

5 

AO— A3 

6 

A3.5-A7 

7 

A7.5-A9.5 

8 

F0-F3 

9 

F3.5-F7 

10 

F7.5-F9.5 

11 

G0-G3 

12 

G3.5—G7 

13 

G7.5-G9.5 

14 

K0-K3 

15 

K3.5-K7 

16 

K7.5-K9.5 

17 

MO— M3 

i 

18 

M3.5-M9.5 

19 

i 

R 

20 

N 

21 

1 

C 

22 

S 

23  j 

! 

WR , WC,  WN 
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For  those  stars  having  only  ptg  observed, 


B = ptg  + a2  + c2 
V = B - (B  - V)* 


(3-10) 


where  (B-V)*  is  the  mean  difference  of  B and  V., magnitudes  for  the  spectral 
class  range. 

Note  that  the  values  of  (B-V)*  do  not  correspond  to  intrinsic  B-V  values  such 
as  those  reported  in  Reference  23.  The  latter  are  for  stars  having  no  inter- 
stellar reddening,  whereas  (B-V)*  reflects  the  mean  interstellar  reddening 
of  the  subsets  of  stars  analyzed. 

The  values  of  a^  , a^  , and  (B-V)*  which  were  obtained  are  listed  in  Table  3-7 
for  the  appropriate  spectral  class  ranges.  The  mean  errors  in  converted  B 
and  V magnitudes  were  found  to  be  about  0. 1 magnitude  in  V and  0. 15  in  B.  How- 
ever, larger  errors  in  B exist  when  B was  obtained  from  Equation  (3-9),  and 
for  V from  Equation  (3-10).  The  best  estimates  of  these  errors  are  shown  in 
the  form  of  error  allowances  presented  in  Table  3-8  for  each  configuration  of 
methods  for  obtaining  B and  V.  For  purposes  of  this  table,  observed  B and  V 
magnitudes  were  assigned  an  error  of  0. 1 magnitude.  The  error  allowance 
for  source  flags  3 through  11  are  estimates  of  the  error  expected  to  be  en- 
countered when  using  these  magnitude  data. 

The  visual  and  photographic  magnitudes  given  in  the  SAO  catalog  were  converted 
to  B and  V by  the  technique  used  for  the  HD  magnitudes.  Figures  3-4  and  3-5 
and  Equations  (3-11)  and  (3-12)  give  the  correction  factors  as  a function  of 
magnitude  (c  and  c ) , and  Table  3-9  gives  the  correction  factors  as  a function 

1 Li 

of  spectral  type. 


| -0.199  - 0.023  ptv  (ptv  ^ 7.75) 
C1  | -0.64  + 0.08  ptv  (ptv>  7.75) 


(3-11) 
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Table  3-7.  Correlation  Results  for  Magnitude  Conversion 


SPECTRAL 

CLASS 

RANGE 

ai 

(MAGNITUDES) 

32  . 

(MAGNITUDES) 

(B— V)# 

(MAGNITUDES) 

1 

-0  20 

+0.11 

+0.25 

2 

-rO.OI 

+0.08 

+0  12 

3 

+0.03 

+0.03 

-0.03 

4 

+0  02 

+0  02 

-0.01 

5 

+0.06 

+0.05 

+0.11 

6 

+0.05 

+0.07 

+0.26 

7 

+0.05 

+0.07 

+0  29 

8 

+0.06 

+0.03 

+0.38 

9 

+0.06 

+0.01 

+0.47 

10 

+0.08 

-0.02 

+0  53 

,i 

+0.05 

+0.01 

+0  64 

12 

+0  03 

-0  03 

+0.85 

13 

-0.01 

-0.05 

+0.93 

14 

-0.02 

-0.02 

+1  14 

15 

-0.04 

+0.09 

+1  40 

16 

+0.04 

-0  07 

- 

17 

-0.06 

+0.02 

+1  57 

18 

-0.06 

0.00 

+1  62 

19 

-0  12 

+0.11 

+1  25 

20 

-0.03 

•K)  11 

- 

21 

-0.01 

-0  01 

- 

22 

-0  08 

+0.06 

- 

23 

+0.02 

+0.05 

! 

+0  22 
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Table  3-8.  Error  Allowances  for  Various  Methods  of  Obtaining  B and  V 


MAGNITUDE 

SOURCE 

FLAG 

i 

MAGNITUDE  SOURCE 

ERROR 

ALLOWANCE 

(MAGNITUDES) 

1 

OBSERVED,  REFERENCE  8 OR  REFERENCE  19 

0.1 

2 

OBSERVED,  B OR  V FROM  REFERENCE  33;  THE  OTHER  NOT  GIVEN 

0 1 

3 

CONVERTED  HD  OR  SAO,  USING  EQ.  (3-8) 

0.4 

4 

CONVERTED  HD  OR  SAO,  USING  EQ.  (3-9) 

0.5 

5 

CONVERTED  HD  OR  SAO,  USING  EQ.  (3-10) 

0.7 

6 

UNCONVERTED  HD  (V^ptv.  B=ptg),  NOT  CONVERTED  BECAUSE 
SPECTRAL  CLASS  WAS  UNAVAILABLE 

0.8 

7 

SAME  AS  MAGNITUDE  SOURCE  FLAG  6,  WHEN  ONLY  V =*  ptv 
WAS  AVAILABLE 

0.8 

8 

SAME  AS  MAGNITUDE  SOURCE  FLAG  6,  WHEN  ONLY  B «=  ptg 
WAS  AVAILABLE 

1.0 

9 

B FROM  REFERENCE  39;  V FROM  SPECTRAL  TYPE  IF  AVAILABLE 

08 

10 

V OBSERVED,  REFERENCE  8 OR  19;  B OBTAINED  FROM 
EQ.  (3-9) 

0 1 (IN  V) 
0.3  (IN  B) 

11 

SAME  AS  MAGNITUDE  SOURCE  FLAG  10  WHEN  NO  B COMPUTED 
DUE  TO  LACK  OF  SPECTRAL  CLASS  INFORMATION 

0 1 (IN  V) 
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Figure  3-4.  Correction  to  SAO  Photovisual  Magnitudes 


CORRECTION 

TO 

PHOTOGRAPHIC 

MAGNITUDE 

(MAGNITUDES) 


Figure  3-5- 


Correction  to  SAO  Photographic  Magnitude 
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Table  3-9.  Spectral  Type-Dependent  Correction  Factors  for 
SAO  Magnitudes 


CLASS 

NUMBER 

ai 

a2 

1 

0.00 

0.11 

2 

0.00 

0.07 

3 

0.01 

0.04 

4 

0.02 

0 01 

5 

0.05 

0.01 

6 

0.05 

-0.01 

7 

0.04 

0.03 

8 

0 05 

0.04 

9 

0,05 

0.06 

10 

0.08 

0.03 

11 

0.05 

0.05 

12 

0.04 

0.03 

13 

0.01 

0.03 

14 

0.00 

-0  01 

15 

-0.02 

0.01 

16 

0.04 

-0.02 

17 

-0.05 

0.13 

18 

-0.05 

0.06 

19 

0.02 

0.00 

20 

0.03 

0.00 

21 

0.05 

-0.13 

22 

-0.08 

0.00 

23 

0.02 

-0  02 
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c2  = -0.161  +0.0377  ptg  (3-12) 

3.5  INTERSTELLAR  ABSORPTION  COMPUTATION 

The  interstellar  absorption  function,  I(X)  , which  enters  into  the  computation 
of  instrumental  magnitudes  in  Equation  (3-6),  has  been  repeatedly  measured 
(see  Reference  24).  To  good  approximation,  it  can  be  thought  of  as  a constant 
curve  everywhere  in  space  except  for  a scaling  factor  (amplitude).  Figure  3-6, 
combined  from  References  25  and  26,  gives  the  shape  of  this  function.  Note 
that  absorption  is  very  much  higher  in  the  ultraviolet  regions  of  the  spectrum 
(below  3500  A)  than  in  the  visual  or  red  regions.  Consequently,  a star  affected 
by  interstellar  absorption  will  have  its  longer  wavelength  (red)  photons  absorbed 
to  a lesser  extent  than  its  short  wavelength  (blue)  photons,  and  will  appear  red- 
der than  its  intrinsic  color.  This  effect  is  called  interstellar  reddening. 

The  amplitude  of  the  interstellar  absorption  function  depends  on  the  amount 
of  gas  and  dust  along  the  line  of  sight  from  the  Earth  to  the  star.  For  any' 
given  direction,  it  is  a monotomcally  increasing  function  of  distance.  We  have 
evaluated  the  absorption  amplitude  as  a function  of  distance  for  various  direc- 
tions (see  Section  3.5.2).  Therefore,  if  the  distance  to  a star  is  known,  the 
interstellar  absorption  amplitude  can  be  estimated.  Section  3.  5. 1 deals  with 
the  evaluation  of  distances  to  stars.  Section  3.  5.2  discusses  the  computation 
of  the  interstellar  absorption  function  from  the  UBV  photometry  or  from  the 
distance.  Section  3.5.3  is  an  application  of  the  absorption  function  to  compute 
U magnitudes  for  stars  not  having  an  observed  U magnitude. 

3.5.1  Distance  Calculations 

Distances  to  stars  are  computed  in  a number  of  ways  (see  Reference  27);  how- 
ever, only  three  of  these  are  applicable  to  sufficiently  large  numbers  of  Master 
Catalog  stars  to  warrant  their  discussion  here. 
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Figure  3-6.  Relative  Interstellar  Absorption  as  a Function  of  Wavelength 
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3 . 5 . 1 . 1 Trigonometric  Parallax 

By  observing  a relatively  nearby  star  against  a background  of  distant  objects 

at  opposite  ends  of  the  Earth's  orbit  (6  months  apart),  a small  trigonometric 

parallax  can  sometimes  be  seen  (Figure  3-7).  The  size  of  this  effect  is  always 

less  than  1 arc-second.  Knowing  the  trigonometric  parallax  angle  in  seconds 

of  arc,  p , as  shown  in  Figure  3-7,  the  distance  in  parsecs,  d , to  the  star 

16 

(1  parsec  = 3.085678  x 10  m)  , can  be  computed  from 

d =-  (3-13) 

P 

Trigonometric  parallaxes  from  Reference  28  are  available  for  about  5 percent 
of  the  Master  Catalog  stars,  but  the  mean  error  in  parallax,  also  given  for 
each  star  in  Reference  28,  is  often  comparable  to,  or  even  greater  than,  the 
parallax. 

Because  the  error  quoted  in  Reference  28  is  arrived  at  by  comparison  of  mul- 
tiple measurements  of  the  same  star,  it  does  not  take  into  account  systematic 
errors  which  vary  from  observatory  to  observatory  (Reference  29).  A total 
error  (one  standard  deviation)  in  the  parallax  equal  to  0.  007  arc-second  or  the 
catalog  mean  error  in  the  parallax  converted  to  a standard  deviation  by  Equa- 
tion (3-14),  whichever  is  greater,  has  been  conservatively  assigned. 

1 standard  deviation  = 1.46  x 1 mean  error  (3-14) 

A very  distant  star  may  still  have  a positive  parallax  due  to  random  observation 
errors.  To  avoid  computing  erroneous  distances  for  cases  such  as  this,  no 
distance  is  calculated  unless  the  parallax  exceeds  three  times  the  measurement 
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standard  deviation  by  at  least  0.005  arc-second.  If  it  does,  an  expectation 
value  of  the  distance  is  estimated  from 


d 

P 


Jp-3€  P0 


f 

J n- 


2 , 2 

r<p-p0.)  /2Cp  ^ 


p+3c  2 , 2 

p e-(p-p0)  /2*  d 

p-3€  1 


(3-15) 


where  p = measured  parallax,  in  arc-seconds 

e = error  in  the  parallax  (1  standard  deviation),  in  arc-seconds 
P 

d = distance  in  parsecs 
P 

The  integration  procedure  is  necessary  because  distance  is  not  a linear  function 
of  parallax.  Equation  (3-15)  was  developed  assuming  that  the  errors  in  meas- 
ured parallax  follow  a Gaussian  distribution.  The  limits  of  the  integral  are 
taken  to  be  three  standard  deviations  from  the  measured  parallax. 

For  stars  with  measured  parallaxes  that  fail  to  exceed  three  measurement 
standard  deviations  by  0.  005  arc-second  (some  may  even  be  negative),  it  is 
still  possible  to  derive  a minimum  distance  to  the  star  by  assuming  that  the 
true  parallax  is  no  more  than  three  standard  deviations  greater  than  the  meas- 
ured parallax.  Thus,  the  minimum  distance  to  the  star  is 


d . 
min 


P + 3e 


(3-16) 


To  avoid  computation  of  the  integral  in  Equation  (3-15),  closed  form  approxi- 
mations were  developed.  These  formulae  and  regions  of  validity  are  given  in 
Figure  3-8;  they  are  everywhere  accurate  to  better  than  0.7  parsec. 
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For  stars  with  distances  computed  from  Equation  (3-15),  the  error  in  the  dis- 
tance, ex  , is  estimated  from 


€ 

X 


1 

2 


_1  1 
p"p-€p 


_1 

P 


1 


(3-17) 


3. 5. 1.2  Spectroscopic  Parallax 

Because  a star's  spectral  type  gives  a measure  of  the  intrinsic  (absolute) 
energy  distribution  (see  Section  3.4.1),  and  the  apparent  magnitude  gives  a 
measure  of  its  apparent  brightness  at  the  Earth,  a comparison  of  the  two  can 
be  used  to  compute  the  distance.  This  technique  is  known  as  spectroscopic 
parallax. 

The  apparent  visual  magnitude,  V , is  related  to  the  absolute  visual  magnitude, 

M , by 
v 


V = M +5  log  . d - 5 + a (3-18) 

v 10  s v 

where  M = absolute  visual  magnitude  (apparent  magnitude  if  the  star  were  at 
v a distance  of  10  parsecs  with  no  interstellar  absorption) 

d = distance  to  the  star  in  parsecs 
s 

a = the  amount  of  interstellar  absorption  at  the  visual  (V)  magnitude, 
in  magnitudes 

In  Equation  (3-18),  only  d is  an  unknown,  although  a is  a function  of  dis- 

s v 

tance.  The  absolute  visual  magnitude  can  be  derived  from  the  spectral  type 
(see  Reference  30  and  Table  3-10).  An  iterative  solution  of  Equation  (3-18)  was 
performed,  starting  with  the  estimate  that  a^  = 0 . Using  this  assumption,  a 
distance,  dg  , was  computed  from  Equation  (3-18).  A value  of  a^  was  then 
obtained  from  the  reddening  versus  distance  study  presented  in  Appendix  B, 
and  a new  value  of  the  distance  computed.  The  procedure  was  repeated  until 
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Table  3-10.  Absolute  Magnitude  as  a Function  of  Spectral  Type 
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values  of  computed  at  successive  steps  differed  by  less  than  0.01  magni- 
tude. 

To  compute  the  expected  error  in  this  distance,  Equation  (3-18)  is  rewritten  as 

log  d = 0. 2 V - 0. 2 M +1.0 -0.2  a (3-19) 

10  s v v 

The  anticipated  error  in  V is  computed  according  to  the  procedure  used  in 

calculating  V (Section  3.4.2).  The  error  in  a^  is  set  such  that  the  three 

standard  deviation  level  in  the  absorption  is  equal  to  the  full  absorption.  Thus, 

the  error  in  a is  equal  to  a /3  . 

v v 

me  error  in  the  absolute  magnitude,  M , comes  from  the  following  two 
sources: 

• Error  in  the  spectral  type.  For  stars  with  observed  MK  types,  this 
is  assumed  to  be  one-tenth  of  a spectral  class  and  one-third  of  a 
luminosity  class.  For  stars  with  only  HD  or  SAO  spectral  types, 
this  is  taken  as  three-tenths  of  a spectral  class  and  two-thirds  of 

a luminosity  class. 

• Error  in  the  conversion  of  spectral  type  to  absolute  magnitude.  If 
the  spectral  type  is  well  known,  this  error  is  probably  quite  small. 
It  is  assigned  a value  of  0.2  magnitude  or  one-half  the  difference 
between  values  for  adjacent  spectral  class  in  tenths,  whichever  is 
the  greater  (see  Reference  30). 

The  errors  just  discussed  are  used  to  compute  the  expected  error,  , in 
log  d by, 

o 


0.2 


(3-20) 
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where  = error  due  to  spectral  type  error 

e = error  due  to  the  spectral  type  to  absolute  magnitude  conversion 
€ = error  due  to  apparent  magnitude 

O 

- error  due  to  absorption 

The  error,  e (one  standard  deviation),  in  the  distance  obtained  by  spectroscopic 
s 

parallax  is  then 


e 

s 


10(1Og10  V‘i>  . 10(logio  V*/ 


(3-21) 


3.  5. 1.  3 Distance  Limit  Based  on  Space  Velocity 

It  has  been  observed  that  star  motions  relative  to  the  local  standard  of  rest 
(LSR)  are  distributed  approximately  as  a Gaussian  distribution  with  a mean 
nearly  equal  to  zero  and  standard  deviation  dependent  on  spectral  type  (Refer- 
ence 27).  The  LSR  is  a nonrotating  reference  frame  at  the  position  of  the  Sun 
moving  in  a circular  orbit  about  the  galactic  center  with  a velocity  equal  to  the 
mean  velocity  for  stars  in  the  solar  neighborhood  at  the  Sun' s distance  from  the 
galactic  center. 

The  space  velocity  of  a star  relative  to  the  LSR  can  be  obtained  from 


e = e*  + a* 

IT  = H*  + It'  (3-22) 

Z = Z*  T z' 

where  (6*,  it*,  z*)  are  the  components  of  the  space  velocity  of  the  star  relative 
to  the  Sun  in  the  coordinate  system  shown  in  Figure  3-9;  (0,  n,  z)  are  the  com- 
ponents of  the  space  velocity  of  the  star  relative  to  the  LSR;  and  (0',  it' , z') 
are  the  components  of  the  Sun's  velocity  relative  to  the  LSR,  [-9,  -11,  +6  kilo- 
meters per  second  (km/sec)],  respectively  (Reference  27). 
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Figure  3-9.  Coordinate  System  for  Space  Motions,  Epoch  2000.0 
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The  standard  deviations  in  the  stellar  space  velocity  components  (o^,  o^,  o'z) 
are  given  as  a function  of  spectral  type  in  Table  3-11,  adapted  from  Refer- 
ence 27. 

The  following  is  a discussion  of  the  computation  of  a star's  space  velocity  com- 
ponents (0*,  it*,  z*)  relative  to  the  Sun.  This  will  be  accomplished  by  first 
computing  these  components  in  G.  I.  coordinates  and  then  transforming  them  to 
the  rectilinear  galactic  coordinate  frame  defined  above. 

The  computation  of  the  space  velocity  components  in  G.  I.  coordinates  requires 
known  values  of  the  position,  distance,  proper  motion  and  radial  velocity  of 
the  star.  Distance  is  the  variable  which  will  eventually  be  solved  for,  and  the 
position  and  proper  motion  are  available  in  the  Master  Catalog.  Radial  veloc- 
ities are,  however,  not  included  in  the  Master  Catalog,  pending  the  completion 
of  a study  being  done  at  the  University  of  Texas.  Assuming  that  all  stars  have 
zero  radial  velocity  relative  to  the  LSR,  the  observed  radial  velocity  is  the 
negative  of  the  Sun's  motion  in  the  direction  of  the  star.  This  is  computed  from 
the  space  velocity  of  the  Sun  relative  to  the  LSR  (0',  it',  z')  and  the  galactic 
latitude  and  longitude  of  the  star,  which  are  computed  from  the  G.I.  unit  vector 
of  the  star.  The  G.  I.  unit  vector  is  given  by 

(X,  Y,  Z)  = (cos  6 cos  0 4 cos  6 sin  a,  sin  6)  (3-23) 

where  (a,  6)  are  the  right  ascension  and  declination  of  the  star,  respectively. 
The  galactic  latitude  and  longitude  are  obtained  from 

b = sin"1  (-0.  8677  X - 0. 1981  Y + 0.4559  Z) 

(3-24) 

-1  /0.4940  X - 0.4449  Y + 0.7470  Z 
1 an  \ -0.0549  X - 0.8734  Y - 0.4839  Z 


where  (b,  l)  are  the  galactic  latitude  and  longitude,  respectively. 
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Table  3-11.  Standard  Deviations  of  Space  Velocity  Components 


SPACE  VELOCITY  STANDARD 
DEVIATION  (km/sec) 

SPECTRAL  TYPES 

°6 

a 

TT 

a 

z 

0-A2 

l-ll 

11 

12 

9 

A3-M9 

l-ll 

9 

13 

7 

0-A9 

III— IV 

13 

22 

9 

F0-F9 

II 1— IV 

15 

28 

9 

G0-G9 

Ml— IV 

18 

26 

15 

K0-K5 

III  — IV 

21 

31 

17 

K6-M9 

III  — IV 

23 

31 

16 

0— B5 

V 

9 

10 

6 

B6-A2 

V 

9 

15 

9 

A3-A9 

V 

9 

20 

9 

F0-F7 

V 

i 

17 

27 

17 

F8— GO 

V 

18 

26 

20 

G1-M9 

V* 

22 

80 

80 

•THESE  VALUES  ARE  FOR  HIGH  VELOCITY  STARS,  WHICH  OCCUR  OVER  20%  OF  THE  TIME 
IN  SPECTRAL  TYPE  G-M  V,  BUT  RARELY  FOR  OTHER  SPECTRAL  TYPES 
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The  coefficients  in  this  equation  come  from  the  transformation  matrix  given 
below. 

The  value  of  the  radial  velocity  of  the  star,  R , is 


R = [it1  cos  b cos  £ + 0'  cos  b sin  £ + Z'  sin  b] 


(3-25) 


The  G.I.  components  of  the  space  velocity  of  the  star  relative  to  the  Sun  are 


v = R cos  6 cos  a.  - u.d  sin  6 cos  a-ud  cos  6 sin  a 
x 0 a 


Vy  = R cos  6 sin  a - sin  6 sin  a - /j^d  cos  6 cos  a (3-26) 


v = R sin  6 + u.d  cos  6 
z o 


where  (/ j,  , ^)  = the  proper  motion  of  the  star  in  right  ascension  and  declina- 
tion, respectively 

d = the  distance  to  the  star 

The  components  of  the  space  velocity  in  the  rectilinear  galactic  frame  are 
then 


(0*,  77*,  z*) 


(3-27) 


where  the  matrix  [M]  transforms  a vector  in  the  G.I.  frame  to  the  galactic 
frame.  Its  elements  are  the  G.  I.  unit  vectors  of  the  three  galactic  frame  axes 
shown  in  Figure  3-9,  derived  from  the  galactic  pole  and  center  given  in  Ref- 
erence 27. 
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[M]  = 


0.4940 
0. 0549 
-0.8677 


-0.4449 
0. 8734 
-0.1981 


0.7470 
0.4839 
0. 4559 


(3-28) 


Assuming  that  the  velocity  components  relative  to  the  LSR  do  not  exceed  three 
times  the  standard  deviations  given  in  Table  3-11,  a maximum  distance  can  be 
computed  as  follows. 

Invert  Equations  (3-26)  and  (3-27)  to  solve  for  d in  terms  of  0 , as  follows: 

d = (9  - 8 ' - 0.4940  R cos  5 cos  a + 0.4449  R cos  5 sin  0!  - 0.7470  R sin  6)/ 
(-0. 4940  Hq  sin  6 cos  a - 0. 4940  ju^  cos  6 sin  a + 0. 4449  Mg  sin  6 sin  a 

-0. 4449  jU^  cos  <5  cos  a x 0.  7470  Mg  cos  6)  (3-29) 

If  the  denominator  of  Equation  (3-29)  is  positive,  d increases  monotonically 
with  increasing  f?  . In  this  case,  set  0 = 3a0  and  solve  for  d , calling  the 
result  d^  . 

If  the  denominator  is  negative,  d increases  monotonically  with  decreasing  0 . 

In  this  case,  set  0 = -3a-  , and  solve  for  d , calling  the  result  d . In  either 

0 1 

case,  the  solution  for  d^  is  as  large  as  possible  subject  to  the  constraint  that 


which  was  the  assumption  made  above. 
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Next,  invert  Equations  (3-26)  and  (3-27)  in  terms  of  n and  z to  get  the  fol- 
lowing: 


d = (ir  - 7T ' - 0. 0549  R cos  6 cos  a - 0. 8734  R cos  6 sin  a - 0.4839  R sin  6)/ 

(-0.  0549  Mg  sin  6 cos  a - 0.  0549  m^  cos  5 sin  a - 0 . 87 34  Mg  sin  6 sin  a 

+ 0.8734  n cos  6 cos  a + 0.4839  Mg  cos  6)  *'  (3-30) 

d = (Z  - Z’  + 0.  8677  R cos  6 cos  a - 0.1981  R cos  6 sin  a - 0.4559  R sin  6)/ 

(0.  8677  Mg  sin  6 cos  Ct  + 0.  8677  M^  cos  6 sin  a + 0. 1981  Mg  sin  6 sin  a 

- 0. 1981  cos  6 cos  a + 0.4559  Mg  cos  6)  (3-31) 

Solve  Equations  (3-30)  and  (3-31)  as  above  for  d , calling  the  results  d9  and 
, respectively. 

The  maximum  distance  is  then 

d = min  (d  , d , d ) (3-32) 

max  1 16 

Observational  imprecision  in  the  proper  motions  is  typically  about 
1.5  x 10  degrees  per  year  (three  standard  deviations;  Reference  31).  There- 
fore, no  maximum  distance  can  be  computed  for  stars  where  the  absolute  value 
of  each  proper  motion  is  less  than  1.5  x 10  ° degrees  per  year. 


\ 
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3 . 5. 1. 4 Computation  of  a Net  Distance 

If  trigonometric  parallax  and  spectroscopic  distances  are  both  available,  they 
are  combined  to  yield  a net  distance  of 


d 


P 

2 


€ 


d = 


x 

1_ 

2 


+ 


+ 


d 

s 


2 

f 

s 


1_ 

2 


€ 


X 


(3-33) 


where  e is  the  error  (1  a)  in  d and  f is  the  error  (1  a)  in  d . 
x p s s 

The  net  error,  e , in  the  distance  is  computed  from 


If  only  one  distance  estimate  is  available,  it  is  used. 

If  d is  available  and  the  computed  distance  is  less  than  d , it  is  set 
min  mm 

to  d ; if  d is  available  and  the  computed  distance  is  greater  than 
min  max 

d , it  is  set  to  d . If  d . >d  , both  are  ignored.  Whenever  the 
max  max  min  max 

best  distance  is  set  to  d or  d , the  error  is  defined  as  equal  to  the 

min  max 

distance. 

3.5.2  The  Interstellar  Absorption  Index 

The  amplitude  of  the  interstellar  absorption  function,  I , is  obtained  from  either 
observed  U,  B,  and  V magnitudes  or  from  the  distance  to  the  star  using  the 
model  described  below. 


\ 
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The  interstellar  absorption  index,  a^  , is  defined  as  the  amount  of  absorption 
in  the  V filter,  expressed  in  magnitudes.  The  amount  of  absorption  in  any 
other  bandpass  can  then  be  computed  from 


a log 
v &10 

(/  W(X)  E(X)(1  - I(X))  dxj /(J  W(X)  E(X)  dx) 

«,.[( 

f V(X)  E(X)(1  - I(X))  dx|/ i yj 

r \ 

V(X)  E(X)  dx 

0 

(3-35) 


where  a = amount  of  absorption  in  the  other  bandpass,  in  magnitudes 
W(X)  = response  in  that  bandpass  as  a function  of  wavelength 

In  general,  a^  depends  on  the  spectral  energy  distribution  of  the  source,  E(X)  , 
but  for  most  star  energy  distributions  and  sensor  bandpasses,  the  quantity  in 
brackets  is  nearly  constant  (Reference  24). 

3.  5.2.1  Interstellar  Absorption  From  BV  Magnitudes 

If  observed  B and  V magnitudes  exist,  but  U does  not,  the  absorption  in  the 
V magnitude,  , can  be  computed  directly  from  B and  V alone. 

The  color  excess,  E^  , is  first  computed  from 

Eu  = (B-V)  . , - (B-V)  (3-36) 

b ' observed  standard 

where  (B-V)  , , is  given  in  Table  3-12  as  a function  of  spectral  type, 

s taria3.ru 

The  values  in  Table  3-12  were  derived  by  first  plotting,  for  various  spectral 
classes  and  luminosity  classes,  observed  B-V  versus  distance.  Only  those 
stars  were  plotted  that  had  observed  B and  V magnitudes  in  the  UBV  system, 
an  observed  MK  spectral  type,  no  spectral  peculiarity,  and  either  a trigono- 
metric or  spectroscopic  parallax  yielding  a distance  less  than  1000  parsecs. 
These  plots  are  given  in  Appendix  A. 
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Table  3-12.  Smoothed  Values  of  (B-V)_,  , , (2  of  2) 

Standard 


SPECTRAL 

CLASS 

LUMINOSITY  CLASS 

1 

1! 

III 

IV 

V 

GO 

033 

0.77 

0.66 

0 59 

0.57 

G1 

0.88 

0 84 

0.71 

0 62 

0 59 

G2 

0 93 

0.88 

0.75 

0.65 

061 

G3 

0 98 

0.93 

0.79 

0.68 

0 63 

G4 

1.03 

0.95 

0.83 

0.73 

0 66 

G5 

1 08 

0.97 

0.88 

0.77 

0 68 

G6 

1.13* 

1.00 

0.92 

0.82 

0.70 

G7 

1.18* 

1.03 

0.94 

0 85 

0 73 

G8 

1.23* 

1 07 

0.95 

0 88 

0.76 

G9 

1.28* 

1 12 

0.97 

0.93 

0.80 

KO 

1.33* 

1 17 

TOO 

0.96 

0.85 

K1 

1.38* 

1 23 

1 10 

1 00 

0.88 

K2 

1 43* 

1 35 

1.17 

- 

0.93 

K3 

1 48 

1 43 

1.28 

- 

0.97 

K4 

1.53 

1.52 

1.42 

- 

1.05 

K5 

1.56 

1.55 

1 50 

- 

1 11 

K6 

1.57 

1 58* 

1.51* 

- 

1.16 

K7 

1,58 

1.60* 

1.52* 

- 

1.22 

K8 

1.59 

1.62* 

1.53* 

- 

1.28 

K9 

1.60 

1 64* 

1 54* 

- 

1 34 

MO 

1.60 

1 65 

1 55 

- 

1 39 

Ml 

1,61 

1 66 

1 57 

- 

1 44 

M2 

1.62 

1 67 

1 59 

- 

1 48 

M3 

1.63* 

1.68 

1 61 

- 

1 53 

M4 

1 64* 

1 69 

1 64 

- 

1 57 

"SIGNIFIES  UNCERTAIN  RESULTS  DUE  TO  LACK  OF  DATA. 
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Some  stars  on  the  plot,  especially  those  at  larger  distances,  may  show  inter- 
stellar reddening;  hence,  they  appear  at  redder  values  of  B-V  (higher  on  the 
plot)  than  they  would  if  they  were  unreddened.  Other  sources  of  error  are  ob- 
servational imprecision  in  the  magnitude  and  in  the  spectral  types.  Due  to  these 
errors,  some  stars  will  have  B-V  values  bluer  (more  negative)  than  the  mean 
intrinsic  B-V  for  the  spectral  class  and  luminosity  class  plotted.  The  best 
estimate  of  the  intrinsic  (standard)  B-V  is  obtained  by  manual  inspection  of 
each  plot. 

For  each  luminosity  class  considered  (I,  II,  III,  IV,  and  V),  a plot  of  observed 

intrinsic  B-V  versus  spectral  type  was  drawn  (see  Figure  3-10).  A smooth  curve 

was  hand  fit  through  the  data  points  and  adopted  values  of  (B-V)  read 

standard 

from  the  plot. 

The  absorption  in  V is  then  computed  from 


a = 3 E, 
v b 


(3-37) 


which  can  be  obtained  from  Equation  (3-35)  using  the  transmission  curves  pre- 
sented in  Figure  3-1,  or  can  be  found  in  Reference  24. 

3. 5. 2. 2 Interstellar  Absorption  From  UBV  Magnitudes 

If  observed  U,  B,  and  V magnitudes  are  all  available,  the  absorption  computed 
from  Equations  (3-36)  and  (3-37)  is  still  valid.  However,  the  U magnitude  is 
another  piece  of  data  which  can  be  used  to  compute  a^_  . This  is  accomplished 
using  the  following  equations  (Reference  27): 


E = (U-B)  , - (U-B)  ^ , , 

u observed  standard 

1/2 

-0.72  - (0.518  - 0.  20  E ) 

E — 

b 0.10 


(3-38) 


a =3EL 
v b 
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Figure  3-10.  Estimated  B-V  Spectral  Class  Plots  and  Smoothed  B-V  Curve  (1  of  5) 
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Figure  3-10.  Estimated  B-V  Spectral  Class  Plots  and  Smoothed  B-V  Curve  (2  of 
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Figure  3-10.  estimated  B-V  Spectral  Class  Plots  and  Smoothed  B-V  Curve  (3  of  5) 
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where  E = the  color  excess  in  U-B,  and  (U-B)sfanrlarr|  is  found  in 
Table  3-13  as  a function  of  spectral  type 


(U-B)  A , , is  derived  in  the  same  manner  as  (B-V)  , ,.  Plots  of 

v 'standard  standard 

measured  intrinsic  U-B  are  given  in  Figure  3-11.  Appendix  A contains  the 


distance  versus  U-B  plots. 


The  adopted  value  of  a is  obtained  by  averaging  the  results  of  Equations  (3-37) 

and  (3-38),  weighting  the  results  of  Equation  (3-37)  four  times  as  heavily  as 

those  of  Equation  (3-38).  This  reflects  the  larger  uncertainty  in  (U-B)  ^ 

due  to  the  sensitivity  of  (U-B)  , , to  spectral  type. 

standard 

3. 5. 2. 3 Interstellar  Absorption  as  a Function  of  Distance 

To  compute  the  interstellar  absorption  in  the  V magnitude  (a^)  , a procedure 
identical  to  that  of  Reference  23  was  used,  using  the  SKYMAP  Master  Catalog 
data  base  as  input  data. 


Only  SKYMAP  stars  having  the  following  data  available  were  used  in  the  study: 

• Observed  MK  spectral  type 

• Observed  B,  V magnitudes 

The  sky  was  divided  into  920  zones,  overlapping  50  percent  in  both  right  ascen- 
sion and  declination.  Color  excess  (E^)  , distance  plots  were  drawn  for  each 
zone.  These  are  presented  in  Appendix  B.  A curve,  consisting  of  one  or  two 
line  segments,  was  then  hand  drawn  through  each  plot. 

The  following  rules  were  applied: 


• The  curve  had  to  pass  through  the  theoretically  certain  point 
(E^  = 0 , distance  = 0)  . 

• The  curve  had  to  be  continuous. 

• E^  could  never  decrease  with  increasing  distance. 

The  slope  of  the  lines  is  the  amount  of  color  excess  per  unit  distance. 
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Table  3-13.  Smoothed  Values  of  (U-B)0  , , (1  of  2) 

Standard 


SPECTRAL 

LUMINOSITY  CLASS 

or  w w i nnc 

CLASS 

1 

(1 

Ilf 

iV 

V 

09 

-1  15 

- 

- 

- 

-1.07 

80 

-1.06 

-1.08 

-0.99 

-0.98* 

-0.99 

81 

-0.97 

-0.96 

-0.92 

-0.90 

-0.90 

B2 

-0  89 

-0.85 

-0.85 

-050 

-0  77 

83 

-0  80 

-0.74 

-0.78 

-0.71 

-0.67 

B4 

-0.70 

-0.62 

-0.70 

-0  63 

-0.60 

B5 

-0.61 

-0.51 

-0.63 

-0  54 

-0  54 

B6 

-0.52 

-0.40* 

-0.57 

-0.47 

-0  48 

B7 

-0.44 

-0.30* 

-0.50 

-0  40 

-0.41 

B8 

-0.36 

-0  19* 

-0.40 

-0.30 

-0.30 

B9 

-0.27 

-0.07* 

-0.25 

-0.20 

-0  11 

AO 

-0.20 

0.03* 

-0.12 

-0  10 

-0.00 

At 

-0.13* 

0.15* 

-0.01 

0 00 

0.03 

A2 

-0.09* 

0.26* 

0.06 

0 06 

0.06 

A3 

-0.06* 

0.38* 

0 12 

0.09 

0 08 

A4 

-0.05* 

0.42* 

0 12 

0.10 

0.10 

A5 

-0.04* 

0.38 

0.11 

0 11 

0.11 

A6 

-0.02* 

0.32 

0.10 

0.11 

0.11 

A7 

0.00* 

0.28 

0.10 

0.10 

0.10 

A8 

0.03* 

0.24 

0 10 

0 10 

0.10 

A9 

0.09* 

0.21 

0.10 

0.09 

0 07 

F0 

0.13* 

0.18 

0.09 

0.08 

0.04 

FI 

0.18* 

0.16 

0.08 

0 06 

0 02 

F2 

0 22* 

0 17 

0 07 

004 

0.01 

F3 

0.27* 

0.19 

0 06 

0 02 

0 00 

F4 

0.32* 

0.21 

0 05 

0.00 

0 00 

F5 

0.37* 

0 24 

0.04 

0.00 

-0  01 

F6 

0.41* 

0.29 

0.05 

0 01 

-0.01 

F7 

0.45 

0.33 

0.07* 

0.04 

0.00 

F8 

0.50 

0.37 

0.12* 

0 10 

0.02 

F9 

0 55 

0.41 

0 20* 

0.15 

004 

• ORIGIN AL  PAGE  JS 
POOR  QUALITY 


Table  3-13.  Smoothed  Values  of  (U-B)  , , (2  of  2) 

' 'Standard  v 


spectral 

CLASS 

LUMINOSITY  CLASS 

1 

II 

III 

IV 

V 

GO 

0.60 

0.44 

0 26* 

0 20 

0.05 

G 1 

0 63 

0 50 

0.33* 

0.23 

0.07 

02 

0.66 

0.55 

0 40* 

0 25 

0 08 

03 

0.70 

0.60 

0.47* 

0.28 

0.10 

04 

0 73 

0.64 

0 53 

0 32 

0.15 

05 

0 77 

0.69 

0.59 

0.38 

0 20 

G6 

0.80 

0.73 

0.62 

0 43 

0.25 

07 

0 84 

0.78 

0.65 

0 49 

0 30 

08 

0.88 

0.83 

0.68 

0.53 

0.35 

09 

0.91 

0.90 

0.75 

0.60 

0.41 

KO 

0.94 

1.09* 

0.83 

0.65 

0.48 

K1 

0.98 

1.23* 

1 00 

0.75* 

0.53 

K2 

1.01 

1.40* 

1 20 

- 

0.60 

K3 

1.04 

1.55 

1.44 

- 

0.77 

K4 

1.06 

1.68 

1.67 

- 

0 95 

K5  j 

1.09* 

1.70* 

186 

- 

1.05 

K6 

1.11* 

1.70* 

1.91* 

- 

1.10 

K7 

1.13* 

1.71* 

1.93* 

- 

1 13 

K8 

1.15* 

1.72* 

1.95* 

- 

1.17 

K9 

1.17* 

1.73* 

1 95* 

- 

1.20 

MO 

1.19* 

1.74* 

1.94 

- 

1 23 

Ml 

1.20* 

1.75* 

1.92 

- 

1 22 

M2 

1.22* 

1.76 

1 90 

- 

1.21 

M3 

1.24* 

1.76 

187 

- 

1.20 

m 

- 

1.77 

1 80* 

- 

1 20 

•SIGNIFIES  UNCERTAIN  RESULTS  OUE  TO  LACK  OF  DATA. 
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Figure  3-11.  Estimated  U-B  Spectral  Class  Plot  and  Smoothed  U-B  Curve  (1  of  5 
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Figure  3-11.  Estimated  U-B  Spectral  Class  Plot  and  Smoothed  U-B  Curve  (5  of  5) 
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The  results  were  then  smoothed,  and  the  relation  a^  = 3 E^  applied  to  yield 
the  adopted  relationship  of  a^  to  both  distance  and  galactic  coordinates.  This 
is  presented  in  Figure  3-12.  For  stars  with  galactic  latitudes  more  than  20  de- 
grees from  the  equator,  av  is  assumed  to  be  zero. 

3.5.3  Computation  of  U Magnitudes 

For  stars  not  having  measured  U magnitudes,  the  following  procedure  was 
employed. 

First,  a correlation  of  observed  U magnitude  as  a function  of  B and  V mag- 
nitudes and  spectral  types  was  performed,  using 

U°  = a + j3  B°  + (1  - jS)  V°  (3-39) 

where  a and  j3  are  coefficients  computed  using  a least  squares  algorithm  for 
each  range  of  spectral  class  and  luminosity  class  given  in  Table  3-14;  B°  and 
V°  are  B and  V magnitudes  of  the  star  with  the  interstellar  absorption  removed 
to  yield  intrinsic  magnitudes;  and  the  variable  thereby  computed,  U°  , is  the 
U magnitude  of  the  star  with  the  interstellar  absorption  ignored.  The  computed 
values  of  a,  P and  the  standard  deviation  in  U are  given  in  Table  3-14. 

The  results  of  the  correlation  were  then  applied  to  all  stars  having  B and  V mag- 
nitudes, spectral  types,  and  reddening  indices  to  yield  a U°  magnitude.  Fi- 
nally, 


U = U°  + a (3-40) 

u ' ' 

where  Au  is  the  interstellar  absorption  in  the  U filter  and  is  given  in  Refer- 
ence 27  as 


A =1.57  A -r 
u v 


0.  006  A2 


v 


(3-41) 
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Figure  3-12.  Adopted  Relationship  of  av  to  Distance  and 
Galactic  Coordinates  (1  of  6) 
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Figure  3-12.  Adopted  Relationship  of  av  to  Distance  and 
Galactic  Coordinates  (2  of  6) 
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Figure  3-12. 


Adopted  Relationship  of  a^  to  Distance  and 
Galactic  Coordinates  (3  of  6) 
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Figure  3-12.  Adopted  Relationship  of  to  Distance  and 
Galactic  Coordinates  (4  of  6) 
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Figure  3-12.  Adopted  Relationship  of  to  Distance  and 
Galactic  Coordinates  (5  of  6) 
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Figure  3-12.  Adopted  Relationship  of  a^,  to  Distance  and 
Galactic  Coordinates  (6  of  6) 
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Table  3-14.  Spectral  Class/Luminosity  Class  Categories 
and  Coefficients  for  Computation  of  U 


NUMBER 

SPECTRAL 

CLASSES 

LUMINOSITY 

CLASSES 

a 

0 

STANOARD 
DEVIATION  IN 
U (MAGNITUDE) 

1 

0— B 

1 

-0.57 

3.02 

0.10 

2 

A-F 

1 

-0.26 

2.13 

0.19 

3 

G-M 

1 

-0.76 

264 

0 26 

4 

CD 

1 

O 

II 

-0.45 

3 35 

0.14 

5 

A-F 

It 

0.12 

1.17 

0 10 

6 

G-M 

II 

-0.66 

2.52 

0.18 

7 

m 

1 

O 

III 

-0.38 

2.72 

0.22 

8 

A-G5 

III 

-0.07 

1.67 

0 15 

9 

G6-M 

III 

-0  86 

2.75 

0.15 

10 

0— A 

IV 

-0.23 

3 63 

0.15 

11 

F-K 

IV 

-0  37 

2.09 

0 16 

12 

CD 

1 

O 

V 

-0.18 

3 87 

0.18 

13 

UL 

1 

< 

V 

-0.01 

1.06 

0.10 

14 

G-M 

V 

-0.75 

2.77 

0.28 
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3.6  VARIABLE  STAR  DATA 

Approximately  2 percent  of  the  stars  in  the  Master  Catalog  are  known  to  have 
variable  magnitudes.  The  cause  of  the  variation  may  be  changes  in  the  star 
itself,  such  as  pulsation,  or  physical  blocking  of  the  star  by  a companion 
(eclipse).  The  Master  Catalog  contains  sufficient  data  about  each  variable 
star  to  determine  its  magnitude  at  any  given  time  provided  that  the  variations 
are  regular. 

The  magnitude  of  a variable  star  is  normally  predictable  and  characterized  by 
a functional  form  of  given  period  and  amplitude.  Knowing  the  functional  form 
(type  of  variation),  period,  amplitude  (difference  between  brightest  and  dimmest 
magnitudes)  and  phase  (current  time  minus  epoch  time),  the  magnitude  at  the 
current  time  is  readily  calculable  from 


m(t)  = m'  + Av  [t  - t , (modulo  P)] 

epoch 


(3-42) 


where  m'  = brightest  magnitude 

A = amplitude  of  variation 

P = period  of  variation 

t , = epoch  time 
epoch 

v(t)  = functional  form  of  the  variation 

Because  the  meaning  of  epoch  and  the  exact  functional  form  of  the  variations 
differ  by  type  of  variable,  one  must  refer  to  References  9 and  32  to  make  use 
of  Equation  (3-42).  This  function  U(t)  is  obtained  by  decoding  a flag  in  the 
Master  Catalog  (see  Section  4.5)  which  refers  to  the  functional  form  in  Refer- 
ences 9 and  32.  Stars  listed  as  being  irregular  variables,  semiregular  vari- 
ables or  novae  are  unpredictable,  and  have  no  values  of  the  epoch  or  period. 
Thus  Equation  (3-42)  cannot  be  used.  The  minimum  and  maximum  brightness 
provided  in  the  Master  Catalog  do,  however,  provide  limits  on  the  magnitude. 
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3.7  MULTIPLE  STAR  DATA 

Because  analytical  techniques  to  identify  star  sensor  observations  may  confuse 
one  star  with  a nearby  companion  or  neighbor,  it  is  often  desirable  to  have  in- 
formation on  the  brightness  of,  and  angular  distance  to,  the  next  closest  star. 
This  is  referred  to  below  as  "nearest  neighbor"  data.  Stars  brighter  than 
8.  0 magnitude  often  do  not  have  neighboring  stars  closer  than  0. 5 degree  unless 
they  are  members  of  a multiple  star  system  (onean  which  two  or  more  stars 
are  physically  associated,  i.e.,  gravitationally  bound) . Therefore,  nearest 
neighbor  data  depends  heavily  on  multiple  star  data. 

The  Master  Catalog  multiple  star  data  obtained  from  Reference  33  consists 
of  the  difference  in  magnitude  between  the  brightest  and  the  second  brightest 
star  in  the  system,  and  the  separation  between  them. 

Since  the  measurement  of  separation  was  made  at  a specific  time,  typically 
20  to  100  years  ago,  the  separation  may  have  changed  due  to  the  motion  of  the 
stars  about  one  another.  For  virtually  all  stars  with  separations  over  30  arc- 
seconds,  however,  the  separation  changes  very  slowly  because  the  orbital  pe- 
riods are  on  the  order  of  thousands  of  years. 

For  stars  which  are  not  members  of  multiple  star  systems,  the  distance  to  the 
nearest  neighboring  star  in  the  Master  Catalog,  and  the  distance  to  the  nearest 
neighboring  star  in  the  Master  Catalog  which  met  certain  magnitude  restric- 
tions (see  Section  4)  were  computed.  This  search  was  performed  to  a limit  of 
0.5  degree.  Stars  not  having  neighbors  within  this  limit  are  shown  as  having 
no  nearest  neighbor.  Reference  46  analyzes  the  accuracy  of  nearest  neighbor 
data. 


3-72 


ORIGINAL  PAGE  IS 
OF  POOR  QUALITY 


SECTION  4 - MASTER  CATALOG  FORMAT 


This  section  is  a description  of  the  Master  Catalog  format,  including  a definition 
of  each  variable.  Table  4-1  lists  the  Master  Catalog  data  words  for  each  star. 
All  words  are  four  bytes  for  ease  in  access.  The  column  marked  "IF  NONE" 
gives  the  value  stored  in  the  position  for  the  variable  if  that  data  is  not  valid. 

The  source  refers  to  whether  the  data  was  taken  from  an  external  source 
catalog,  or  was  computed  internally  using  SKYMAP  software. 

Each  of  the  words  of  data  listed  in  Table  4-1  is  described  below. 

4.1  STAR  NUMBERS  AND  NAMES 

Star  numbers  and  names  are  provided  in  the  Master  Catalog  to  allow  easy  cross- 
reference  to  printed  star  catalogs.  The  word  number  refers  to  that  shown  in 
Table  4-1. 

4.1.1  Word  1 

HD  numbers  are  defined  in  Reference  8 in  order  of  increasing  right  ascension, 
epoch  1900.  0 (Word  23).  Values  range  from  1 to  225300  for  original  HD  stars, 
and  from  225301  to  approximately  280,000  for  HD  Extension  stars. 

4.1.2  Word  2 

The  SKYMAP  number  is  a running  index,  as  defined  in  Section  3.  2. 1.  Numbers 
were  assigned  in  catalog  order;  i.  e. , in  order  of  increasing  right  ascension 
at  the  standard  epoch  (2000.  0)  (Word  13). 

4.1.3  Word  3 

The  SAO  number  is  a 6-digit  integer  used  principally  in  the  SAO  catalog  (Refer- 
ence 4).  These  numbers  are  assigned  sequential^  within  declination  zones 
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10  degrees  wide,  beginning  at  the  North  Celestial  Pole.  Therefore,  increasing 
SAO  numbers  correspond  approximately  to  decreasing  declination,  epoch  1950. 0 
(Word  22). 

4.1.4  Word  4 

The  Durchmusterung  number  (DM  number)  is  a coded  composite  of  the  DM  zone 
and  sequential  index  (see  Section  3.2.2).  It  is  an  8-digit  integer,  the  first 
three  digits  of  which  represent  the  1 -degree-high  declination  zone  (epoch  1855.0) 
into  which  the  star  falls,  and  the  last  five  digits  of  which  form  a sequential  index 
within  that  zone  assigned  in  order  of  increasing  right  ascension  (epoch  1855. 0). 
Words  96  through  99  are  a formatted  equivalent  of  this  word. 

4.1.5  Word  5 

The  HR  number,  from  the  Yale  Catalog  of  Bright  Stars  (Reference  15),  is  fre- 
quently cross-referenced  in  scientific  literature.  It  is  defined  in  order  of  in- 
creasing right  ascension,  epoch  1950.0,  beginning  with  1 and  ending  with  9110. 

4.1.6  Word  6 

The  Aitken  Double  Star  (ADS)  number,  originally  defined  in  Reference  17,  is  a 
designation  for  multiple  stars.  It  is  a 5-digit  integer,  assigned  in  order  of  in- 
creasing right  ascension,  epoch  1900. 0. 

4.1.7  Word  7 

The  Variable  Star  Catalog  sequence  number  (Reference  9)  is  given  for  all  vari- 
able stars  in  the  Master  Catalog.  It  was  originally  defined  in  alphabetical  order 
of  constellation,  and  therefore  bears  no  relation  to  the  position  of  the  star. 

4.1.8  Words  8 Through  10 

The  star  name  (or  Flamsteed  name)  is  a Greek  letter  and/or  Arabic  number 
followed  by  the  name  of  the  constellation  containing  the  star.  It  is  encoded 
here  as  a formatted  field  with  Greek  letters  represented  by  three  character 


4-10 


Revised  August  1980 


ORIGINAL  PAGE  IS 
OF  POOR  QUALITY 


transliterations,  and  constellations  as  three  character  abbreviations.  The 
star  name  is  frequently  used  in  the  literature  for  stars  brighter  than  6. 0 
magnitude. 

4.1.9  Words  11  and  12 

The  variable  name  consists  of  one  or  two  letters  and  an  abbreviation  of  the 
name  of  the  constellation  containing  the  star.  Variable  stars  are  frequently 
referred  to  by  this  name. 

4.  2 POSITIONS  AND  PROPER  MOTIONS 

The  parameters  presented  in  this  section  allow  computation  of  the  position  of 
each  star  at  any  epoch.  This  is  accomplished  by  adding  corrections  for  proper 
motion  and  precession  to  the  position  given  at  a standard  epoch  (see  Section  3.3). 

4.2.1  Words  13  and  14 

The  basic  position  in  the  Master  Catalog  is  the  right  ascension  and  declination 
at  the  standard  epoch,  which  is  2000. 0.  These  data  come  preferentially  from 
the  SAO  (Reference  4)  which  contains  all  stars  with  accurately  known  positions 
and  proper  motions.  Lacking  SAO  data,  these  words  come  from  References  39, 
8,  9,  33,  3,  and  40. 

Formatted  equivalents  of  these  data  words  appear  in  Words  100  to  106. 

4.2.2  Word  15 

The  error  in  the  standard  epoch  position  is  taken  from  the  SAO  catalog  for  SAO 
stars.  For  AGK-3  stars,  it  is  set  to  0.5  arc-second  (see  Reference  41).  For 
HD  or  HDE  positions  it  is  35  arc-seconds  (see  Reference  42),  and  for  all  others, 
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it  is  100  arc-seconds.  The  error  in  right  ascension,  € , approximately  equals 
the  error  in  declination,  , and  is  given  by: 


e 

a 


€TOT//v/^_ 


(4-1) 


where  = total  error  (Word  15) 

4.2.3  Words  16  and  17 

Galactic  latitude  and  longitude  are  computed  using  Equation  (3-21).  Galactic 
latitude  is  referenced  to  the  North  Galactic  Pole,  which  is  at  right  ascension  = 
12^51^4  and  declination  = +27°71 2,  epoch  2000.0.  Galactic  longitude  is  ref-  • 
erenced  to  the  zero  point  with  right  ascension  = and  declination  = 

-28°56’,  epoch  2000.0,  which  points  to  the  galactic  center  (Reference  27). 

4.2.4  Words  18  Through  20 

Right  ascension  and  declination  at  the  standard  epoch  were  converted  to  a G.I. 
(standard  epoch)  unit  vector  according  to  Equation  (3-23). 

4.2.5  Words  21  and  22 

These  right  ascensions  and  declinations  are  taken,  in  order  of  preference,  from 
Reference  4,  39,  8,  19,  18,  or  33. 

4.2.6  Words  23  and  24 

These  right  ascensions  and  declinations  are  taken  from  the  HD  catalog,  or  its 
Extension,  and  are  valid  only  for  HD  stars. 

4.2.7  Words  25  and  26 

Proper  motion  refers  to  the  motion  of  the  star  across  the  sky  due  to  the  ve- 
locity of  the  star  relative  to  the  Sun.  Equation  (3-3)  may  be  used  to  apply  proper 
motion  corrections  from  one  epoch  to  another.  The  magnitude  of  the  effect 
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is  usually  less  than  20  arc-seconds  per  hundred  years,  though  occasionally  it 
is  as  large  as  1 arc-minute  per  hundred  years.  All  stars  with  known  proper 
motion  are  included  in  the  SAO  or  AGK-3;  therefore,  the  Master  Catalog  stars 
not  in  the  SAO  and  AGK-3  do  not  have  measured  proper  motions.  These  have 
been  defaulted  to  0.0.  Lack  of  proper  motion  may  lead  to  positional  errors  of 
up  to  1 arc-minute  per  hundred  years  as  the  epoch  is  moved  away  from  the 
epoch  of  measurement,  1900.  0.  These  stars  can  be  recognized  as  lacking 
proper  motion  data  because  their  source  of  position  (Word  90)  will  be  different 
from  1 or  8. 

4.2.8  Words  27  and  28 

Precession  is  a correction  in  position  due  to  the  motion  of  the  Earth's  spin 
axis.  The  magnitude  of  the  effect  is  approximately  one-half  degree  in  decli- 
nation and  1 degree  in  right  ascension  per  hundred  years.  It  has  been  cal- 
culated for  all  Master  Catalog  stars  using  Equation  (3-4). 

4.2.9  Words  29  and  30 

The  total  correction  in  position  needed  to  transform  from  one  epoch  to  another 
is  the  sum  of  proper  motion  (Words  25  and  26)  and  precession  (Words  27  and  28). 
For  convenience,  these  are  summed  and  presented  in  Words  29  and  30.  For 
those  stars  lacking  proper  motion  data,  these  variables  represent  precession 
alone.  Formatted  equivalents  of  these  words  are  given  in  Words  108  and  109. 

4.3  MAGNITUDES  AND  SPECTRAL  TYPES 

The  spectral  energy  distribution  of  a star  as  a function  of  wavelength  is  required 
to  determine  the  instrumental  magnitude  of  that  star  [see  Equation  (3-6)].  Pre- 
cise observations  of  this  distribution  are  available  for  only  a handful  of  stars. 
However,  two  measures  of  spectral  energy  distribution  are  widely  available — 
magnitudes  within  known  bandpasses,  and  qualitative  overall  descriptions  of  the 
spectrum  of  the  star  (spectral  type). 
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4.3.1  Word  31 


C7t*G.SAL 

Of  POOS 


Paul's 

Dhurry 


The  ultraviolet  (U)  magnitude  of  the  UBV  system  (Reference  5)  is  centered  at 
about  3500  A and  has  an  800  A half-width  (see  Figure  3-1).  If  observed  values 
exist  (from  Words  39  through  41),  they  are  used;  if  not,  values  are  derived 
using  the  procedure  given  in  Section  3.5.3.  When  the  U magnitude  has  not  been 
observed,  and  when  one  or  more  of  the  data  words  needed  for  its  computation 
is  not  available,  no  U magnitude  is  computed.  " 

4.3.2  Word  32 

This  flag  gives  the  method  by  which  the  best  value  of  the  U magnitude  (Word  31) 
was  obtained.  The  meanings  of  each  value  are  given  below. 

Value  Meaning 

0 No  U magnitude  provided 

1 U magnitude  observed  on  UBV  system 

2 U magnitude  computed  by  procedure  given 

in  Section  3.  5.3 

3 U-B  observed  and  B computed  from  photo- 
visual and/or  photographic  magnitudes 

A formatted  equivalent  of  this  word  is  given  in  Word  110. 

4.3.3  Words  33  and  34 

o 

The  best  values  of  the  B (effective  wavelength  4400  A)  and  V (effective  wave- 
0 

length  5500  A)  magnitudes  were  obtained  whenever  possible  from  observed 
magnitudes  (Words  39  and  40).  When  these  were  not  available,  they  were 
derived  according  to  the  procedure  given  in  Section  3.4.2.  For  variable  stars, 
either  B or  V magnitude  is  listed  (from  Reference  9)  and  it  refers  to  the 
brightest  that  the  variable  star  will  be.  All  Master  Catalog  stars  have  valid 
values  of  either  V or  B. 
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B and  V magnitudes  were  calculated  in  various  manners,  as  specified  in  Sec- 
tion 3.4.2.  Anticipated  errors  associated  with  each  method  are  given  in 
Table  3-8.  A formatted  equivalent  of  this  word  is  given  in  Word  111. 

4.3.5  Words  36  and  37 

These  are  the  photovisual  and  photographic  magnitudes  from  the  HD  catalog, 
or  the  SAO  catalog  for  non-HD  stars.  They  correspond  approximately  to  V 
and  B,  respectively,  but  no  spectral  response  curves  are  available  for  them. 

4.3.6  Word  38 

The  validity  flag  for  the  photovisual  and  photographic  magnitudes  is  defined 
below. 

Value  Meaning 

0 Neither  photovisual  nor  photographic  available 

1 Both  photovisual  and  photographic  available  from 
observations 

2 Photovisual  available  from  observation  and 
photographic  derived  from  photovisual  and  spec- 
tral type 

3 Photographic  available  from  observation  and 
photovisual  derived  from  photographic  and 
spectral  type 

4 Photovisual  available  from  observation; 
photographic  not  given 

5 Photographic  available  from  observation; 
photovisual  not  given 

4.3.7  Words  39  Through  41 

These  are  observed  magnitudes  on  the  system  of  Reference  5.  B-V  refers 
to  the  difference  in  B and  V magnitude;  U-B  refers  to  the  difference  of  U and  B. 
Mean  errors  to  be  expected  are  0.  02  magnitude  in  V and  B-V  and  0.  03  magni- 
tude in  U-B.  , 
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The  stars'  spectral  type  is  divided  into  spectral  class,  luminosity  class,  and 
peculiarity  code.  Spectral  class  (Word  42)  is  a measure  of  stellar  tempera- 
ture; the  numerical  code  equivalents  of  the  spectral  classes  are  given  in  the 
table  which  follows.  The  spectral  class  code  is  a 4 -digit  integer. 

The  first  two  digits  give  the  letter  code. 

First  Two  Digits  Letter  Code 


00 

O 

01 

B 

02 

A 

03 

F 

04 

G 

05 

K 

06 

M 

07 

R 

08 

N 

09 

C 

10 

s 

11 

WR 

12 

WC 

13 

WN 

The  third  digit  is  the  number  following  the  spectral  type  letter  code;  e.g. , 
A8  becomes  0280.  If  no  spectral  type  number  is  given,  the  third  and  fourth 
digits  are  7.  For  example,  A becomes  0277. 

The  fourth  digit  is  0 except  for  the  case  described  above,  for  some  O and  M 
stars,  and  for  stars  with  fractional  spectral  types.  For  O and  M stars  with 
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small  letters  following  the  spectral  type  letter  or  number  (e.g. , 08f  or  Ma), 
the  coding  is: 


Fourth  digit 

Meaning 

1 

a 

2 

b 

3 

c 

4 

d 

6 

e 

8 

f 

For  stars  with  a fractional  spectral  type,  the  fraction  is  encoded  in  the  fourth 
digit.  For  example,  B1.5  becomes  0115. 

A few  special  codes  appear,  which  are  as  follows: 

Special  Code 

Meaning 

0000 

No  spectral  class  available 

0990 

Peculiar 

0991 

S star,  no  further  breakdown  given 

Luminosity  class  is  a measure  of  stellar  surface  gravity,  which  affects  the 
structure  of  the  star's  atmosphere  and  thus  its  spectral  energy  distribution. 

The  codes  for  luminosity  class 

are  given  below. 

Code  Meaning 


0 

None 

10 

I 

11 

Ia-O 

12 

la 

13 

la-lab 

14 

lab 
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Code 

Meaning 

15 

I-H 

16 

Iab-Ib 

18 

lb 

19 

Ib-II 

20 

II 

28 

■'  lib 

30 

III 

40 

IV 

50 

V 

60 

VI 

-10 

c 

-30 

o 

© 

-50 

d 

Split  classes  are  averaged;  e.g. , III-IV  becomes  35. 

The  peculiarity  code  specifies  anomalies  in  chemical  composition  of  the  star, 
its  speed  of  rotation,  or  existence  of  an  extended  atmosphere.  The  coding  for 
this  variable  is  given  below.  This  is  a 2-digit  code.  The  printout  abbreviation 
refers  to  program  UPDATE  printed  output  (see  Section  5). 

The  first  digit  is  as  follows: 

Printout 

Number  Meaning  Abbreviation 


1 

Metallic 

M 

2 

Very  rapid  rotator 

NN 

3 

Weak  lined 

WL 

4 

Silicon 

SI 

5 

Composite  spectrum 

COMP 

6 

Shell 

SH 
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Number 

Meaning 

Printout 

Abbreviation 

7 

Variable 

VAR 

8 

4670  star 

4670 

9 

Star  plus  nebula 

NEB 

The  second  digit  is  a sum  of  any  of  the  following  that  apply: 

Number 

Meaning 

Printout 

Abbreviation 

1 

Peculiar 

P 

2 

Rapid  rotator 

N 

4 

Emission  star 

E 

The  following 

special  codes  apply: 

Special 

Codes 

Meaning 

Printout 

Abbreviation 

00 

No  peculiarities  noted 

- 

68 

Calcium  K-line  star 

K 

69 

EQ 

EQ 

78 

S appended  to  spectral  type  (e.g. , M2S) 

S 

79 

Chromium  star 

CR 

88 

Horizontal  branch  star 

HB 

89 

Helium  star 

HE 

98 

Strontium-chromium  star 

SRCR 

99 

Central  star  of  a planetary  nebula 

PLAN 

These  spectral  type  words  are  based  on  the  MK  system  of  Reference  7.  Stars 
for  which  MK  spectral  types  (Words  47  through  49)  have  not  been  observed  have 
had  HD  spectral  types  converted  to  the  MK  system  using  the  procedure  specified 

in  Section  3.4. 

1.  Formatted  equivalents  of  these  words 

are  found  in  Words  112 

through  115. 
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This  variable  specifies  the  source  for  the  spectral  class,  luminosity  class,  and 
peculiarity  code  given  in  Words  42  through  44,  and  are  given  below. 

Value  Meaning 

0 Spectral  class,  luminosity  class,  and  peculiarity 

code  not  available 

1,2,3  Spectral  class,  luminosity  class,  and  peculiarity 

code  observed  in  the  MK  system  and  reported  in 
References  18,  19,  or  8,  respectively 

4 Spectral  class  observed  in  the  HD  system  and 
converted  to  spectral  class  and  luminosity  class 
in  the  MK  system;  the  peculiarity  code  was  set 
to  0 

5 Same  as  4 for  SAO  spectral  types 

6 Same  as  4 for  AGK-3  spectral  types 

A formatted  equivalent  of  this  word  is  found  in  Word  116. 

4.3.10  Word  46 

The  spectral  type  in  the  HD  system  as  given  in  References  3 and  4 consists  of 
a spectral  class  only.  The  coding  is  the  same  as  for  the  MK  system  spectral 
class  shown  in  the  table  in  Section  4.3.8,  page  4-15. 

4.3.11  Words  47  Through  49 

These  words  are  observed  MK  spectral  class,  luminosity  class,  and  peculiarity 
code  from  References  18,  19,  or  8 (listed  in  order  of  preference)  and  correspond 
to  codes  in  the  tables  in  Section  4.3.8. 
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4.3.12  Word  50 

This  is  the  source  flag  for  Words  47  through  49.  The  meanings  of  each  flag 
are  listed  below: 

Value  Meaning 

0 None  available 

1 Taken  from  Reference  18 

2 Taken  from  Reference  19 

3 Taken  from  Reference  8 

4.4  DISTANCES  AND  INTERSTELLAR  ABSORPTIONS 

The  amount  of  interstellar  absorption  is  a variable  entering  into  the  computa- 
tion of  instrumental  magnitudes  (Equation  (3-6)).  It,  in  turn,  is  derived  from 
observed  UBV  magnitudes  or  from  the  star's  distance  and  direction. 

4.4.1  Word  51 

Trigonometric  parallax  is  the  only  direct  measurement  of  distance  available 
to  astronomers  for  objects  outside  of  the  solar  system.  Section  3. 5. 1. 1 dis- 
cusses the  definition  of  trigonometric  parallax.  Only  a small  fraction  of  Master 
Catalog  stars  have  measured  trigonometric  parallaxes  obtained  from  Refer- 
ence 28.  Over  half  of  these  have  parallax  errors  sufficiently  large  compared 
to  the  parallax  itself  so  that  the  parallax  can  be  used  to  establish  a minimum 
distance  to  the  star. 

4.4.2  Word  52 

The  probable  error  in  the  trigonometric  parallax  value  given  in  Word  51  is  also 
taken  from  Reference  28. 

4.4.3  Words  53  Through  55 

The  distance  derived  from  Words  51  and  52,  the  error  in  this  distance  (one 
standard  deviation),  and  the  minimum  derived  distance  (if  the  parallax  is  too 
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small  compared  to  the  error  in  parallax)  are  presented  in  these  words.  Sec- 
tion 3.  5.1. 1 details  how  these  values  are  computed.  All  Master  Catalog  stars 
having  valid  values  of  Word  51  have  valid  values  of  either  Words  53  and  54,  or 
of  Word  55. 

4.4.4  Word  56 

The  absolute  visual  magnitude  of  a star  is  obtained  from  its  spectral  type, 
and  is  used  in  the  computation  of  spectroscopic  distance  (Section  3.  5. 1. 2).  It 
is  defined  as  what  the  observed  (apparent)  visual  magnitude  (V)  would  be  if 
the  star  were  at  a distance  of  10  parsecs  and  no  intersellar  absorption  inter- 
vened. Absolute  magnitudes  are  taken  from  Reference  30,  except  for  those  of 
supergiants,  which  are  taken  from  Reference  34. 

4.4.5  Words  57  and  58 

The  distance  and  error  in  distance  to  a star  based  on  spectroscopic  parallax 
(Section  3.  5. 1. 2)  are  given  in  these  words  for  all  stars  having  valid  values 
for  Word  56. 

4.4.6  Word  59 

The  radial  velocity’’  of  a star  is  defined  as  its  motion  relative  to  the  Sun  in  the 
direction  directly  towards  (negative  values)  or  away  from  (positive  values) 
the  Sim.  Observed  radial  velocities  are  from  Wilson  (Reference  43).  For  stars 
not  in  Wilson,  the  inverse  of  the  Sun's  motion  relative  to  the  local  standard  of 
rest  (LSR)  in  the  direction  of  the  star  is  taken  as  the  radial  velocity.  This  is 
statistically  the  most  likely  value.  Section  3. 5. 1. 3 details  this  calculation  and 
defines  LSR.  The  radial  velocity'  flag  (Word  91)  specifies  if  the  radial  velocity 
is  from  Wilson  or  is  calculated. 

4.4.7  WTords  60  Through  62 

The  8 , n , and  z components  of  the  stars'  space  velocity  relative  to  the  LSR 
are  given  in  the  coordinate  system  defined  in  Section  3. 5. 1.3  and  computed 
according  to  the  procedure  defined  in  that  section.  These  are  compared  to 
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known  dispersions  of  these  velocity  components  given  in  Table  3-11  as  a func- 
tion of  spectral  type  to  yield  a maximum  distance  to  the  star. 

4.4.8  Word  63 

The  maximum  distance  to  the  star  derived  from  Words  60  through  62  according 
to  the  procedure  given  in  Section  3. 5. 1.3  is  given  in  this  word.  All  stars  hav- 
ing valid  values  of  Words  60  through  62  and  a spectral  type  within  the  range 
specified  in  Table  3-9  have  valid  values  for  this  word. 

4.4.9  Words  64  and  65 

The  best  available  distance,  Word  64,  is  computed  from  Words  53,  55,  57,  and 
63  according  to  the  procedure  given  in  Section  3.5. 1.4;  the  error  (one  standard 
deviation)  in  this  estimate,  Word  65,  is  also  computed  as  noted  in  that  section. 

4.4.10  Word  66 

A flag  is  given  which  specifies  how  the  distance  presented  in  Word  64  was  ob- 
tained. The  flag  value  and  its  meanings  are  given  below. 

Meaning 

No  distance  given 

Distance  obtained  from  trigonometric  parallax 
alone 

Distance  obtained  from  spectroscopic  parallax 
alone 

Distance  obtained  is  a combination  of  trigono- 
metric and  spectroscopic  parallax 

Distance  cited  is  a minimum  distance  computed 
from  trigonometric  parallax 

Distance  cited  is  a maximum  distance  computed 
from  space  velocities 

A formatted  equivalent  of  this  word  is  given  in  Word  117. 


Value 

0 

1 

2 

3 

4 

5 
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4. 4. 11  Words  67  and  68 


The  amount  of  interstellar  absorption,  Word  67,  at  the  V filter  is  computed  ac- 
cording to  the  equations  given  in  Section  3.5.2  for  all  stars  with  observed  B and 
V magnitudes  (Words  33  and  34)  or  a valid  distance  (Word  64).  This  can  be 
readily  converted  into  a color  excess  in  B-V,  Word  68,  defined  as  the  amount 
of  increase  in  B-V  due  to  interstellar  absorption.  Section  3.5.2  presents  equa- 
tions showing  how  this  can  be  converted  to  absorptions  in  the  B and  U magnitudes. 

4.4.12  Word  69 

This  flag  indicates  which  method  was  used  to  obtain  interstellar  absorption. 

The  flag  values  and  its  meanings  are  given  below. 

Value  Meaning 

0 No  absorption  given 

1 Absorption  derived  from  B and  V magnitudes  alone 

2 Absorption  derived  from  U,  B’,  and  V magnitudes 

3 Absorption  derived  from  distance  and  direction  to 
the  star 

A formatted  equivalent  of  this  word  is  given  in  Word  118. 

4.  5 VARIABLE  STAR  DATA 

Stars  with  varying  brightness  (variable  stars)  may  present  a problem  to  mission 
planners  and  data  analysts.  If,  for  example,  a sensor's  limiting  magnitude  is 
7.  0,  and  a star  varies  in  brightness  between  6. 0 and  8.  0 magnitudes,  then  a 
data  analysis  program  must  include  the  star  in  its  star  catalog  since  it  is  some- 
times sufficiently  bright  to  be  observed.  On  the  other  hand,  mission  planners 
cannot  be  sure  it  will  be  detectable,  and  so  cannot  plan  on  using  it  for  control 
purposes  unless  they  are  able  to  predict  its  brightness  as  a function  of  time. 

The  information  contained  in  this  section  of  the  Master  Catalog  will  allow  the 
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user  to  pick  out  variable  stars,  determine  their  brightest  and  dimmest  mag- 
nitudes, and,  for  most  stars,  predict  brightness  as  a function  of  time.  Sec- 
tion 3.6  specifies  how  to  predict  the  brightness  of  variable  stars. 

4.5.1  Word  70 

The  variability  type  code  is  a numerical  code  for  the  type  of  variability. 

Table  4-2  cross-references  this  code  to  the  normal  alphabetic  code  used  in 
Reference  32  and  gives  a brief  definition  of  the  type  of  variation.  The  first  digit 
of  the  3-digit  variability  code  gives  the  type  of  variable.  If  it  is  1,  the  star 
is  a pulsating  variable;  most  of  these  stars  have  predictable  variations.  A 2 
signifies  an  eruptive  variable,  usually  having  unpredictable  variations.  A 3 de- 
notes an  eclipsing  variable,  also  usually  having  predictable  variations. 

The  second  digit  of  the  code  denotes  the  class  of  variable;  for  example,  stars 
with  1 as  the  first  digit  and  2 as  the  second  digit  are  all  RR  Lyrae  type  variables. 

The  third  digit  is  the  subclass  of  variable.  A zero  denotes  that  no  subdivision 
exists  for  that  type  of  variable  or  that  the  subdivision  is  unknown  for  that  star. 

4.5.2  Word  71 

If  the  variability  of  a star  is  considered  questionable,  this  flag  is  1;  otherwise, 
it  is  0. 

4.5.3  Words  72  and  73 

For  each  regular  variable  and  many  well-observed  irregular  variables,  the  dif- 
ference between  the  brightest  and  dimmest  magnitudes  possible  for  the  star  is 
given  in  Word  72.  If  Word  73  has  a value  of  1,  the  magnitude  difference  refers 
to  the  B or  the  photographic  magnitude;  if  it  is  2,  Word  72  refers  to  the  V mag- 
nitude. 

4.5.4  Word  74 

The  epoch  of  a variable  star  is  the  time  of  a reference  point  in  its  light  varia- 
tion function,  usually  the  time  when  the  star  is  at  its  dimmest.  It  is  expressed 
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in  Julian  days  minus  2,400,  000.  Reference  32  must  be  consulted  for  more 
detailed  information  on  the  meaning  of  epoch  for  each  type  of  variable.  Irregular 
and  most  semiregular  variables  do  not  have  meaningful  epochs  because  their 
variations  are  too  unpredictable. 

4.5.5  Word  75 

The  period  of  a regular  variable  star  is  the  duration  of  one  cycle  in  its  light 
variation  function.  Irregular  and  most  semiregular  variables  do  not  have 
meaningful  periods  because  their  variations  are  too  unpredictable. 

4.6  MULTIPLE  STAR  DATA 

Whenever  two  stars  brighter  than  the  sensor  limiting  magnitude  are  situated 
close  together  in  the  sky,  data  reduction  programs  may  have  difficulty  deter- 
mining which  was  observed  by  the  sensor.  Therefore,  these  programs  may 
wish  to  avoid  stars  having  nearby  companions.  Control  programs  will  also 
want  to  avoid  selecting  these  stars  as  control  or  guide  stars.  A star  may  have 
a close  companion  if  it  is  a physical  multiple  star,  or  if  it  is  part  of  an  optical 
double — two  stars  which  are  not  physically  associated  but  which  appear  near 
one  another  in  the  sky. 

Physical  double  stars  may  be  recognized  as  having  valid  entries  in  Words  76 
and  77  of  the  Master  Catalog.  Optical  doubles  to  a distance  of  0.5  degree  are 
included,  along  with  physical  doubles,  in  the  nearest  neighbor  computations 
(Words  79  through  83). 

4.6.1  Word  76 

The  separation  of  the  two  brightest  components  of  a physical  multiple  star  is 
given  in  this  word.  The  observation  referred  to  in  Word  76  was  made  in  the 
year  noted  in  Word  78.  If  the  observation  of  a star  occurred  more  than  a few 
years  from  the  epoch  of  interest,  the  stars  of  the  multiple  star  system  may 
have  moved  significantly  relative  to  one  another.  Thus,  the  separation  may  no 
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longer  be  valid.  As  a general  rule,  if  a separation  is  greater  than  approxi- 
mately 30  arc-seconds,  it  will  change  only  very  slowly.  This  is  because,  at 
the  distances  of  virtually  all  stars,  a 30-arc-second  separation  implies  that 
the  stars  are  orbiting  each  other  at  such  large  distances  that  the  period  of  the 
orbit  is  thousands  of  years  or  longer.  Stars  with  smaller  separations  are 
either  (1)  located  very  near  to  one  another,  in  which  case  the  separation  will 
vary  rapidly  but  will  always  be  small,  or  (2)  located  at  a great  distance  from 
one  another  but,  by  chance,  are  now  aligned  nearby  along  the  line  of  sight  from 
the  Earth.  In  the  latter  case,  the  stars  are  moving  very  slowly  relative  to  one 
another,  and  therefore  the  separation  between  them  will  remain  small  for  a long 
period  of  time.  Therefore,  stars  with  separations  over  30  arc-seconds  may  be 
considered  to  always  have  separations  equal  to  the  value  given,  and  stars  with 
smaller  separations  can  always  be  assumed  to  have  separations  smaller  than 
30  arc-seconds. 

4.6.2  Word  77 

The  difference  in  brightness  between  the  two  brightest  components  is  given  in 
Word  77. 

4.6.3  Word  78 

The  year  in  which  the  separation  observation  (Word  76)  was  made  can  be  used 
to  determine  the  validity  of  the  assumption  that  the  separation  is  still  valid 
(see  Section  4.  6. 1).  All  stars  having  a valid  value  of  Word  76  also  have  a valid 
value  in  Word  78. 

4.6.4  Word  79 

The  distance  to  the  nearest  Master  Catalog  star  is  given  in  Word  79.  If  the 
distance  is  more  than  0. 5 degree,  it  is  coded  as  360.  0.  If  the  nearest  neighbor 
is  a member  of  a physical  multiple  star  system  with  this  star,  Word  79  is  made 
negative  (hence,  -0.01  means  that  the  nearest  star  to  this  star  is  0.01  degree 
away  and  is  part  of  a multiple  star  system). 
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4.6.5  Words  80  Through  89 

These  words  are  the  same  as  Word  79,  except  that  for  WTords  80  through  85, 
the  restriction  was  also  imposed  that  the  neighbor  must  be  further  than  the 
star  in  question  than  5,  15,  30,  60,  120,  and  300  arc-seconds,  respectively. 
Words  86,  87,  88,  and  89  are  identical  to  Words  79,  81,  83,  and  85,  respec- 
tively, with  the  additional  restriction  that  the  neighbor  must  be  no  more  than 
2 visual  magnitudes  dimmer  than  the  star  in  question. 

4.7  MISCELLANEOUS  DATA 

Six  data  words  not  required  by  earlier  versions  of  the  catalog  have  been  inserted 
into  these  previously  unused  positions. 

4.7. 1 Word  90 

This  flag  gives  the  source  of  the  star's  position. 


Value 

Source  of  Position 

Reference  Number 

1 

SAO 

4 

2 

HD  or  HD  Extension 

3,  40 

3 

Blanco 

8 

4 

Jaschek 

18 

5 

Multiple  star  catalog 

33 

6 

Parallax  catalog 

28 

7 

Wilson 

43 

8 

AGK-3  catalog 

39 

9 

Variable  star  catalog 

9 

4.7.2  Word  91 

This  flag  gives  the  source  of  the  star's  radial  velocity.  If  it  is  0,  the  radial 
velocity  quoted  is  the  inverse  of  the  Sun's  motion;  if  it  is  1,  the  radial  velocity 
is  from  Wilson  (Reference  43). 
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4.7.3  Word  92 


This  word  gives  the  source  of  multiple  star  data. 

Value  Meaning 


0 

1 

2 - 23599999 


99999999 


4.7.4  Words  93  and  94 


No  multiple  star  data  given 

Multiple  star  data  from 
Reference  33 

Two  or  more  source  catalog  stars 
within  1 arc -minute  of  one  another 
were  combined.  Word  92  gives  the 
SKYMAP  number  of  the  secondary 

Two  or  more  source  catalog 
stars  within  1 arc -minute  of  one 
another  were  combined.  The 
secondary  had  no  HD  number 


Word  93  is  the  systematic  error  in  right  ascension  and  Word  94  is  the  systematic 
error  in  declination  for  HD  stars  in  the  region  of  the  sky  including  this  star. 

See  Reference  42  for  details.  The  correction  must  be  added  to  the  HD  position 
to  correct  the  systematic  error.  Words  93  and  94  are  valid  only  for  stars 
whose  position  comes  from  the  HD  or  HDE  catalogs  (Word  90  is  equal  to  2). 

4.7.5  Word  95 

Some  stars  have  duplicate  entries  in  SKYMAP  because  of  inadequate  cross- 
referencing  between  source  catalogs.  When  duplicate  entries  are  discovered 
and  merged,  the  SKYMAP  number  of  the  entry  that  was  merged  into  this  entry 
is  saved  in  Word  95.  The  SKYMAP  number  of  a merged  entry  will  not  be  used 
for  any  other  star. 

4.8  FORMATTED  DATA 

A number  of  coded  data  words  have  been  converted  into  an  alphameric  format 
for  convenience  in  printing. 
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4.  8. 1 Words  96  Through  99 

The  DM  number  (Word  4)  is  decoded  as  a plus  or  minus  sign  for  the  zone,  the 
zone  number,  and  the  sequence  number  within  the  zone,  and  are  placed  re- 
spectively into  Words  96,  97,  and  98  and  99  (combined). 

4.8.2  Words  100  Through  106 

The  right  ascension  and  declination  at  the  standard  epoch  (Words  13  and  14)  are 
decoded  into  hours,  minutes,  and  seconds  of  time,  and  into  degrees,  minutes, 
and  seconds  of  arc,  respectively. 

4.8.3  Word  107 

The  source  of  the  position  at  the  standard  epoch  is  encoded  in  this  variable  by 
an  examination  of  Word  3.  If  Word  3 is  zero  (no  SAO  number),  the  position  was 
obtained  from  either  the  HD  (Reference  3),  if  Words  23  and  24  are  nonzero,  or 
otherwise  from  Reference  8 or  9.  This  word  is  encoded  as  follows: 

Value  Meaning 

SAO  Position  came  from  the  SAO  catalog  (Reference  4) 

HD  Position  came  from  the  HD  catalog  (Reference  3)  or  its 

Extension  (Reference  40) 

BLAN  Position  came  from  Blanco  (Reference  8) 

JAS  Position  came  from  -Jaschek  (Reference  18) 

MULT  Position  came  from  Multiple  Star  Catalog 

(Reference  33) 

PAR  Position  came  from  Parallax  catalog  (Reference  28) 

WIL  Position  came  from  Wilson  (Reference  43) 

AGK3  Position  came  from  AGK3  catalog  (Reference  39) 

VAR  Position  came  from  Variable  Star  Catalog 

(Reference  9) 
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4.8.4  Words  108  and  109 

The  sum  of  the  proper  motion  and  precession  (Words  29  and  30)  is  given  in 
minutes  of  time  and  minutes  of  arc  for  right  ascension  and  declination,  re- 
spectively. 

4.8.5  Word  110 

The  source  of  the  U magnitude  quoted  in  Word  32  is  encoded  as  follows: 

Value  Meaning 

(blank)  U magnitude  observed  on  the  UBV  system  or  none 

given  in  Word  31 

* U magnitude  computed  as  noted  under  Word  32 

4.8.6  Word  111 

The  source  of  the  V and  B magnitudes  given  in  Words  33  and  34  is  encoded  as 
follows : 


Value  Meaning 

(blank)  B and  V both  observed 

C Converted  HD  or  SAO  magnitudes  as  noted  in 

Word  35 

H Unconverted  HD  or  SAO  magnitudes 

* V observed  in  UBV  system;  B computed  from  V 

and  the  spectral  type  or  not  given  in  Word  33 


4.8.7  Words  112  Through  115 

The  spectral  type  codes  have  been  decoded  to  the  standard  formats  given  in 
Section  4. 3.  8. 
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4.8.8  Word  116 

The  source  of  the  spectral  type  information  given  in  Words  112  through  115  is 
encoded  as  follows: 


Value 


(blank) 

H 

4.8.9  Word  117 


Observed  on  the  MK  system  or  not  given 
Converted  from  the  HD  system 


The  method  by  which  the  distance  (Word  64)  was  derived  is  encoded  as  follows: 


Value 

(blank) 

T 

S 

S,  T 
MIN 
MAX 


Meaning 


No  distance  given 

Distance  from  trigonometric  parallax 

Distance  from  spectroscopic  parallax 

Distance  is  a combination  of  trigonometric 
and  spectroscopic  parallax 

Distance  is  a minimum  distance  from 
trigonometric  parallax 

Distance  is  a maximum  distance  from 
space  velocities 


4.8.10  Word  118 

The  source  of  the  interstellar  absorption  amplitude  (Word  67)  is  encoded  as 
follows : 


Value  Meaning 


(blank) 

None  given 

BV 

Derived  from  B and  V 

UBV 

Derived  from  U,  B and  V 

Derived  from  distance  and  direction 

4-34 


4.8.11  Words  119  and  120 


C f\*  o.  i. ' *• 

r,f  7* 


^ -i  '’.'"r3  p^7 

•'  • ^ _ ’ >» 

y*  . ■»  L- . 1 J 


The  difference  between  B and  V and  between  U and  B magnitudes  (Words  31, 
33,  and  34)  is  given  in  these  words. 

4.8.12  Words  121  and  122 

An  8-character  description  of  the  type  of  variability  is  given  in  this  word. 
Table  4-2  provides  an  interpretation  of  these  codes,  and  a cross-reference  to 
the  numerical  codes  of  Word  70. 
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SECTION  5 - UPDATING  THE  MASTER  CATALOG 


Whenever  it  is  necessary  to  add  data  to,  delete  data  from,  or  change  data  in 
the  Master  Catalog,  care  must  be  exercised  to  avoid  errors  that  would  affect 
existing  Master  Catalog  data.  Accordingly,  program  UPDATE  has  been  written 
to  provide  a structure  within  which  modifications  can  be  made.  Program 
UPDATE  can  do  the  following: 

• Add  stars  to  the  Master  Catalog 

• Delete  stars  from  the  Master  Catalog 

• Add,  delete,  or  change  data  for  stars  in  the  Master  Catalog 

• Compute  those  variables  marked  "Internal"  in  Table  4-1  from 
existing  Master  Catalog  data 

• Output  a subset  of  Master  Catalog  data  (the  Mission  Catalog) 

* 

• Print  part  or  all  of  the  Master  Catalog  data 
5.1  PROGRAM  UPDATE  OVERVIEW 

Figure  5-1  shows  the  logical  flow  for  program  UPDATE.  UPDATE  begins  by 
reading  NAMELIST/FILES/,  which  contains  flags  directing  the  basic  program 
flow.  Subroutine  CONTRL  is  then  called  to  read  NAMELIST/INSTR/,  which 
contains  detailed  instructions  for  the  sections  of  UPDATE  which  add  and  delete 
data. 

Data  for  a single  star  is  read  from  the  input  Master  Catalog.  If  data  for  the 
star  is  to  be  deleted  in  its  entirety,  the  data  for  the  next  star  is  read.  If  not, 
data  for  the  star  is  deleted  and/or  added  as  directed  by  user-input  instructions. 
If  requested,  user-written  subroutine(s)  which  modify  the  star  data  are  now 
called.  These  calls  may  be  skipped  if  a user-specified  Master  Catalog  data 
word  falls  outside  of  user-specified  limits. 
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Figure  5-1.  Logical  Flow  for  Program  UPDATE  (1  of  3) 
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Figure  5-1.  Logical  Flow  for  Program  UPDATE  (2  of  3) 
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Figure  5-1.  Logical  Flow  for  Program  UPDATE  (3  of  3) 
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Each  of  the  words  listed  as  "Internal"  in  Table  4-1  can  be  computed  by 
UPDATE.  The  user  specifies  which  words  are  to  be  computed.  The  calcula- 
tions are  performed  for  (1)  all  stars,  (2)  for  only  those  stars  added  to  the 
Master  Catalog  during  the  runs,  or  (3)  for  all  stars  added  or  having  data  added 
during  the  run,  in  accordance  with  a user-input  parameters. 

If  a Master  Catalog  output  tape  is  desired,  the  star  data  is  written.  Similarly, 
if  requested,  a call  to  the  user-written  subroutine  WRITE M outputs  the  Mission 
Catalog.  If  desired,  the  star  data  is  printed  in  either  a summary  format  or  a 
full  scientific  format. 

If  a star  is  to  be  added  after  the  star  just  processed,  it  is  inserted  into  the 
program  flow  at  this'  point.  UPDATE  allows  data  to  be  added  for  this  star  and 
allows  predefined  and/or  standard  processes  to  be  performed  before  outputting 
the  data  on  the  Master  Catalog,  Mission  Catalog,  and/or  printer  data  set. 

Each  star  on  the  input  Master  Catalog  is  processed  in  turn  until  an  end  of  file 
is  encountered.  UPDATE  then  prints  a terminating  message  and  stops. 

5.2  MATHEMATICAL  SPECIFICATIONS 

All  of  the  mathematical  specifications  for  UPDATE  are  given  in  Section  3 . 

5.  3 BASELINE  DIAGRAM  AND  UNIT  DESCRIPTIONS 

5.3.1  Baseline  Diagram 

Figure  5-2  is  a baseline  diagram  for  program  UPDATE. 

5.3.2  Unit  Descriptions 

A unit  description  of  program  UPDATE  and  each  subroutine  is  presented  in 
Sections  5.  3.  2. 1 through  5. 3.  2.  30.  An  explanation  of  the  tabular  formats  used 
in  these  sections  is  given  in  Section  2.4. 1.  Appendix  C is  a FORTRAN  compiler 
listing  of  UPDATE. 
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The  following  is  an  index  to  all  program  UPDATE  modules . 
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5 . 3 . 2 . 1 Program  UPDA  TE 

DESCRIPTION:  UPDATE  calls  subroutines  to  read  input  Master  Catalog  data, 
adds  and  deletes  stars  or  data  for  an  existing  Master  Catalog  star,  and  calls 
subroutines  to  perform  computations  with  star  data,  to  output  the  Master  and 
Mission  Catalogs,  and  to  produce  printed  output  of  star  data. 

CALLING  SEQUENCE:  None.  (UPDATE  is  the  main  program.) 

COMMON  AREAS  REFERENCED:  ABBLK,  ABSBLK,ADDBLK,  CNTBLK, 

FLBLK,  PRCBLK , PRTBLK , SIGBLK , 
STDBLK 

EXTERNAL  REFERENCES:  CONTRL, PRNTIT,READNX, STAND, SUB1, 

SUB2,  SUB3 , SUB4.SUB5,  SUB6 , WRITE M , ZERO, 
ZTIME 

INPUT/OUTPUT  DATA-  SETS:  FORTRAN  data  set  reference  number  5 is 
NAMELIST/FILES/  input.’  FORTRAN  data  set  reference  number  IFILE(22) 
is  error  message  and  trace  message  printed  output.  FORTRAN  data  set  ref- 
erence number  ICNT(2,  I)  is  star  data  input  for  the  Ith  add/delete  process. 
FORTRAN  data  set  reference  number  IFILE(24)  is  Master  Catalog  input. 
FORTRAN  data  set  reference  number  IFILE(26)  is  log  printed  output. 

FORTRAN  data  set  reference  number  IFILE(25)  is  Master  Catalog  output. 

ERROR  MESSAGES: 

'END  OF  FILE  ON  NAMELIST  FILE  5'— No  NAME  LIST/FILE  SAyas  found  on 
unit  5.  One  must  be  supplied. 

'WARNING— FOR  THE  xxTH  PROCESS,  THE  INPUT  DATA  SET  FILE  NUMBER 
vy  IS  EMPTY. ' — The  data  set  (on  file  number  vy)  for  the  xxth  add/delete  proc- 
ess was  empty.  UPDATE  ignores  this  add/delete  instruction. 
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UPDATE 


'WARNING — FOR  THE  xxTH  PROCESS,  A STAR  TO  BE  DELETED  (yyyyyy) 

IS  NOT  IN  THE  MASTER  CATALOG’  where  xx  is  the  number  of  the  add/delete 
process  and  yyyyyy  is  the  SKYMAP  number  of  the  star  to  be  deleted.  UPDATE 
ignores  this  delete  instruction.  Note  that  delete  records  not  being  in  numerical 
order  of  SKYMAP  number  may  cause  this  error. 

'WARNING— FOR  THE  xxTH  PROCESS,  A STAR  WITH  DATA  TO  BE  DELETED 
(yyyyyy)  IS  NOT  IN  THE  MASTER  CATALOG'  where  xx  is  the  number  of  the 
add/delete  process  and  yyyyyy  is  the  SKYMAP  number  of  the  star  with  data 
to  be  deleted.  UPDATE  ignores  this  delete  data  instruction.  Note  that  delete 
data  records  not  being  in  numerical  order  by  SKYMAP  number  may  cause  this 
error. 

’WARNING— FOR  THE  xxTH  PROCESS,  A STAR  WITH  DATA  TO  BE  ADDED 
(yyyyyy)  IS  NOT  IN  THE  MASTER  CATALOG’  where  xx  is  the  number  of  the 
add/delete  process  and  yyyyyy  is  the  SKYMAP  number  of  the  star  with  data 
to  be  deleted.  UPDATE  ignores  this  delete  data  instruction.  Note  that  delete 
data  records  not  being  in  numerical  order  by  SKYMAP  number  may  cause  this 
error. 

'WARNING— FOR  THE  xxTH  PROCESS,  A STAR  WITH  DATA  TO  BE  ADDED 
(yyyyyy)  IS  NOT  IN  THE  MASTER  CATALOG’  where  xx  is  the  number  of  the 
add/delete  process  and  yyyyyy  is  the  SKYMAP  number  of  the  star  with  data 
to  be  added.  UPDATE  ignores  this  add  data  instructions.  Note  that  add  data 
records  not  being  in  numerical  order  of  SKYMAP  number  may  cause  this  error. 
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5.  3.  2. 2 Subroutine  ABBMV 

DESCRIPTION:  ABBMV  computes  the  mean  B-V  and  the  HD  magnitude  to 
UBV  magnitude  conversion  coefficients  for  the  input  spectral  class. 

CALLING  SEQUENCE:  Subroutine  ABBMV  (ISTC,  A,  B,  BMV,  IFLAG,  FMAG, 
GMAG) 

COMMON  AREAS  REFERENCED:  ABBLK 
EXTERNAL  REFERENCES:  None 
INPUT/OUTPUT  DATA  SETS:  None 
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5 . 3 . 2 . 3 Subroutine  A BSMA  G 

DESCRIPTION:  ABSMAG  calculates  the  absolute  magnitude  of  a star  of  spectral 
type  and  luminosity  class  represented  by  1ST,  ILEFT,  and  ILC. 

CALLING  SEQUENCE:  Subroutine  ABSMAG  (1ST, ILEFT, ILC, A) 

COMMON  AREAS  REFERENCED:  ABSBLK 

EXTERNAL  REFERENCES:  None 

INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2. 4 Subroutine  AMCONV 

DESCRIPTION:  AMCONV  converts  Master  Catalog  data  to  the  alphameric 
Master  Catalog  words  indicated  as  being  "Internal"  in  Table  4-1. 

CALLING  SEQUENCE:  Subroutine  AMCONV  (X,  IX) 

COMMON  AREAS  REFERENCED:  FLBLK,  PRCBLK 

EXTERNAL  REFERENCES:  INTG,  LCONV1,  LCONV2,  LCONV3,  LCONV4, 

LCONV5,  LCONV6,  LCONV7,  LCONV8 

INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2.  5 Subroutine  CONTRL 

DESCRIPTION:  CONTRL  reads  NAMELIST/INSTR/ which- contains  detailed 
instructions  for  the  add/delete  processes.  CONTRL  also  checks  these  input 
variables  to  ensure  that  they  are  within  the  allowed  range. 

CALLING  SEQUENCE:  Subroutine  CONTRL(IC) 

COMMON  AREAS  REFERENCED:  CNTBLK,  FLBLK 

EXTERNAL  REFERENCES:  None 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  IC  is 
NAMELIST/INSTR/  input.  FORTRAN  data  set  reference  number  IFILE(22) 
is  error  message  output. 

ERROR  MESSAGES: 

'WARNING— ITY  INDICATES  A NULL  PROCESS  OR  AN  UNDEFINED  PROCESS. 
ITY  = xxx. ' where  ITY  = xxx  . Only  values  between  1 and  6 are  meaningful. 
UPDATE  ignores  this  add/delete  process. 

'ERROR— FOR  THE  xxTH  PROCESS,  THE  FILE  DEFINED  yy  IS  ALREADY 
IN  USE. ' The  input  file  (yy)  for  the  xxth  add/delete  process  was  previously 
defined  as  a NAMELIST  read,  printed  output  or  Master  Catalog  input  file,  or 
as  an  input  file  for  a previous  add/delete  process.  The  user  should  change 
the  duplicated  file  number.  UPDATE  stops. 

’WARNING— FOR  THE  xxTH  PROCESS— A DELETE  DATA  PROCESS,  NDEL 
(yyyyyyyy)  WAS  NOT  POSITIVE.  * For  add/delete  process  number  xx,  the  num- 
ber of  data  words  to  be  deleted  (yyyyyyyy)  was  not  positive.  UPDATE  ignores 
this  process. 

•ERROR— FOR  THE  xxTH  PROCESS,  NDEL  (yyyyyyyy)  WAS  LARGER  THAN 
THE  LIMIT,  20. ' For  add/delete  process  number  xx,  the  number  of  data  words 
to  be  deleted  was  greater  than  the  maximum  allowed,  20.  UPDATE  stops. 
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'ERROR— FOR  THE  xxTH  PROCESS,  THE  yyTH  WORD  TO  BE  DELETED  IS 
AN  ILLEGAL  VALUE — zzzz.  ’ For  add/delete  process  number  xx,  the  yyth 
word  to  be  deleted  lies  outside  of  the  limits  1 £ zzzz  ^ 131.  UPDATE  stops. 

'WARNING— FOR  THE  xxTH  PROCESS,  AN  ADD  DATA  PROCESS,  NADD 
(yyyyyyyy)  WAS  NOT  POSITIVE.'  For  add/delete  process  number  xx,  the  num- 
ber of  words  of  data  to  be  added,  yyyyyyyy,  was  not  positive.  UPDATE  ignores 
this  add/delete  process. 

'ERROR— FOR  THE  xxTH  PROCESS,  NADD  (yyyyyyyy)  WAS  LARGER  THAN 
THE  LIMIT,  20. ' For  add/delete  process  number  xx,  the  number  of  data 
words  to  be  added  was  greater  than  the  maximum  allowed,  20.  UPDATE  stops. 

'ERROR— FOR  THE  xxTH  PROCESS,  THE  yyTH  WORD  TO  BE  ADDED  IS  AN 
ILLEGAL  VALUE — zzzz. ' For  add/delete  process  number  xx,  the  yyth  word 
to  be  added  lies  outside  of  the  limits  1 £ zzzz  ^ 131.  UPDATE  stops. 

'ERROR— FOR  THE  xxTH  PROCESS,  THE  SUBROUTINE  NUMBER  SPECIFIED 
(yyyyyyyy)  IS  AN  ILLEGAL  VALUE. ' For  add/delete  process  xx,  the  subroutine 
number  to  be  called  must  be  1 s yyyyyyyy  £ 6.  UPDATE  stops. 

'ERROR— FOR  THE  xxTH  PROCESS,  THE  CONDITIONAL  VARIABLE,  IVARTS, 
IS  yyyyyyyy,  AN  ILLEGAL  VALUE.'  For  add/delete  process  number  xx,  the 
variable  to  be  tested  for  conditional  application  of  the  process  is  not  within  the 
allowed  range  l £ yyyyyyyy  s 131.  UPDATE  stops. 

'ERROR— FOR  THE  xxTH  PROCESS,  ITSTYP  = yyyyyyyy  WHICH  DOES  NOT 
AGREE  WITH  THE  FORMAT  OF  MASTER  CATALOG  WORD  zzzz.  ’ For  add/ 
delete  process  number  xx,  the  type  of  the  conditional  variable  was  yyyyyyyy, 
which  does  not  agree  with  the  Master  Catalog  data  type  for  word  zzzz.  UPDATE 
stops . 

’ERROR— FOR  THE  xxTH  PROCESS,  ITSTYP  = yyyyyyyy,  AN  ILLEGAL 
VALUE. ' For  add/delete  process  number  xx,  the  type  of  conditional  variable 
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was  yyyyyyyy,  which  is  outside  of  the  allowed  range: 
UPDATE  stops. 

'WARNING— OVER  20  PROCESSES  CALLED  FOR.' 
esses  are  allowed.  More  than  that  are  ignored. 


CONTRL 

i s yyyyyyyy  s 2. 


Only  20  add/delete  proc- 
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5 . 3 . 2 . 6 Subroutine  IDIGI T 

DESCRIPTION:  Subroutine  IDIGIT  converts  a 4-digit  integer  into  four  1-digit 
integers. 

CALLING  SEQUENCE:  Subroutine  IDIGIT  (I,N,  JA,  JB,  JC,  JD) 

COMMON  AREAS  REFERENCED:  None 
EXTERNAL  REFERENCES:  None 
INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2.  7 Subroutine  IN  TABS 

DESCRIPTION:  Subroutine  INTABS  computes  the  interstellar  absorption  for 
a given  direction  and  distance  from  the  Sun. 

CALLING  SEQUENCE:  Subroutine  INTABS  (DIST, B, EL, ABSORB) 

COMMON  AREAS  REFERENCED:  None 
EXTERNAL  REFERENCES:  None 
INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2.  8 Subroutine  INTG 

DESCRIPTION:  Subroutine  INTG  converts  four  A1  variables  into  the  equivalent 
A4  variables. 

CALLING  SEQUENCE:  Subroutine  INTG  (IA,IB,IC,ID,ERES) 

COMMON  AREAS  REFERENCED:  None 
EXTERNAL  REFERENCES:  None 
INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2.  9 Function  LCONV1 

DESCRIPTION:  LCONV1  converts  a 2-digit  integer  into  the  4-byte  alphameric 
equivalent,  left  justified  and  filled  with  two  blanks.  The  first  digit,  if  zero,  is 
set  to  a blank. 

CALLING  SEQUENCE:  Function  LCONVl(I) 

COMMON  AREAS  REFERENCED:  None 
EXTERNAL  REFERENCES:  IDIGIT,INTG 
INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2. 10  Function  LCONV2 

DESCRIPTION:  LCONV2  converts  a 4-digit  positive  integer  to  its  4-bvte  alpha- 
meric equivalent. 

CALLING  SEQUENCE:  Function  LCONV2(I) 

COMMON  AREAS  REFERENCED:  None 
EXTERNAL  REFERENCES:  IDIGIT.INTG 
INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2. 11  Function  LCONV3 

DESCRIPTION:  LCONV3  converts  a 1-digit  positive  integer  to  its  alphameric 
equivalent,  left  justified  and  blank  filled. 

CALLING  SEQUENCE:  Function  LCONV3(I) 

COMMON  AREAS  REFERENCED:  None 

EXTERNAL  REFERENCES:  INTG 

INPUT/OUTPUT  DATA  SETS:  None 
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5.3.2.12  Function  LCONV4 

DESCRIPTION:  LCONV4  converts  a floating  point  number,  F,  such  that 
F s 0.0,  into  a 4-b3de  alphameric  equivalent  in  the  format  XX.  X,  where  X is 
a digit. 

CALLING  SEQUENCE:  Function  LCONV4(F) 

COMMON  AREAS  REFERENCED:  None 
EXTERNAL  REFERENCES:  IDIGIT.INTG 
INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2. 13  Function  LCONV5 

DESCRIPTION:  LCONV5  converts  a floating  point  number,  F,  such  that 
IF!  £ 9.949,  into  a 4-byte  alphameric  equivalent  in  the  format  ±X.  X,  where 
X is  a digit  and  ± is  a plus  or  a minus  sign. 

CALLING  SEQUENCE:  Function  LCONV5(F) 

COMMON  AREAS  REFERENCED:  None 

EXTERNAL  REFERENCES:  INTG 

INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2. 14  Function  LCONV6 

DESCRIPTION:  LCONV6  converts  a floating  point  number,  F,  such  that 
j F ! £ 99.49,  into  a 4-byt'e  alphameric  equivalent  in  the  format  ±XX. , where 
X is  a digit  and  ± is  a plus  or  a minus  sign. 

CALLING  SEQUENCE:  Function  LCONV6(F) 

COMMON  AREAS  REFERENCED:  None 

EXTERNAL  REFERENCES:  INTG 

INPUT/OUTPUT  DATA  SETS:  None 
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5.3.2.15  Function  LCONV 7 

DESCRIPTION:  LCONV7  converts  a floating  point  number,  F,  such  that 
| Fj  ^ 99.49,  into  a 4-byte  alphameric  equivalent  in  the  format  =bXX,  where 
X is  a digit,  M is  a blank,  and  i is  a plus  or  a minus  sign. 

CALLING  SEQUENCE:  Function  LCONV (F) 

COMMON  AREAS  REFERENCED:  None 

EXTERNAL  REFERENCES:  INTG 

INPUT/OUTPUT  DATA  SETS:  None 
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5.3.2.16  Function  LCONV8 

DESCRIPTION:  LCONV8  converts  a floating  point  number,  F,  such  that 
-0.  9949  s F ^ 9.  949,  into  a 4-bvte  alphameric  equivalent  in  the  format 
X.XX,  where  X is  a digit  if  F s 0.  00  and  -.  XX  is  F ^ 0.  0. 

CALLING  SEQUENCE:  Function  LCONV(F) 

COMMON  AREAS  REFERENCED:  None 

EXTERNAL  REFERENCES:  IDIGIT.INTG 

INPUT/OUTPUT  DATA  SETS:  None 
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5.3.2.17  Subroutine  PRECES 

DESCRIPTION:  Subroutine  PRECES  -precesses  star  coordinates  from  one  epoch 
to  another. 

CALLING  SEQUENCE:  Subroutine  PRECES  (DX,  APRE,  EPOCHA,  EPOCHB, 
EPREA, EPRED) 

COMMON  AREAS  REFERENCED:  PRCBLK 
EXTERNAL  REFERENCES:  None 
INPUT/OUTPUT  DATA  SETS:  None 
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5.3.2.18  Subroutine  PRNTIT 

DESCRIPTION:  Subroutine  PRNTIT  produces  printed  output  of  Master  Catalog 
data. 

CALLING  SEQUENCE:  Subroutine  PRNTIT  (IFPRNT,  X,  IX) 

COMMON  AREAS  REFERENCED:  FLBLK,  PRTBLK 
EXTERNAL  REFERENCES:  None 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  IFILE(26) 
is  log  printed  output.  FORTRAN  data  set  reference  number  IFILE(22)  is  error 
message  printed  output.  FORTRAN  data  set  reference  number  IFILE(27)  is 
NAMELIST/XPRINT/  input.  FORTRAN  data  set  reference  numbers  IFLPRT(I), 
1 = 1,  . . . , 10  are  printed  output. 

ERROR  MESSAGES: 

'ERROR— AN  END  OF  FILE  WAS  ENCOUNTERED  ON  THE  NAMELIST/ 
XPRINT/  FILE.  PRINTOUT  IS  CANCELLED. ' File  IFILE(27)  does  not  contain 
NAMELIST/XPRINT/.  No  printout  is  generated. 

'ERROR— THE  CONDITIONAL  PRINT  VARIABLE,  ICOND,  HAS  AN  ILLEGAL 
VALUE  (xxxxxx).  PRINTOUT  IS  CANCELLED.’  The  first  conditional  print 
variable  must  be  a Master  Catalog  word.  Accordingly,  it  must  satisfy  /xxxxxx/ 
^ 131  or  1001  £ xxxxxx  £ 1004.  No  printout  is  produced. 

'ERROR— THE  CONDITIONAL  PRINT  VARIABLE,  ICOND2,  HAS  AN  ILLEGAL 
VALUE  (xxxxxx).  PRINTOUT  IS  CANCELLED.’  The  second  conditional  print 
variable  must  be  a Master  Catalog  word.  Accordingly,  it  must  satisfy  /xxxxxx/ 
^ 131  or  1001  ^ xxxxxx  £ 1004.  No  printout  is  produced. 
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5.3.2.19  Subroutine  READNX 

DESCRIPTION:  Subroutine  READNX  reads  a record  from  an  add/delete  proc- 
ess input  file. 

CALLING  SEQUENCE:  Subroutine  READNX(IPR) 

COMMON  AREAS  REFERENCED:  ADDBLK,  FLBLK 
EXTERNAL  REFERENCES:  None 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  IFILE 
(IPR)  is  add/delete  process  input. 
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5.  3.  2.  20  Subroutine  SCLASS 

DESCRIPTION:  Subroutine, SCLASS  converts  a spectral  class  code  to  a class 
number,  as  defined  in  Table  3-6. 

CALLING  SEQUENCE:  Subroutine  SCLASS(ISTC) 

COMMON  AREAS  REFERENCED:  None- 

EXTERNAL  REFERENCES:  None 

INPUT /OUTPUT  DATA  SETS:  None 
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5.3.2.21  Subroutine  SIGMA 

DESCRIPTION:  Subroutine  SIGMA  computes  the  mean  standard  deviations  for 
the  three  galactic  velocity  components  as  a function  of  spectral  class  and  lumi- 
nosity class.  Table  3-11  gives  the  values  that  are  output. 

CALLING  SEQUENCE:  Subroutine  SIGMA  (ISPT,ILC,SIGTHT,SIGPI,SIGZ) 

COMMON  AREAS  REFERENCED:  SIGBLK 

EXTERNAL  REFERENCES:  None 

INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2.  22  Subroutine  STAND 

DESCRIPTION:  STAND  computes  the  numerical  variables  noted  as  "Internal" 
in  Table  4-1. 

CALLING  SEQUENCE:  Subroutine  STAND  (X,  IX,  ISTFST) 

COMMON  AREAS  REFERENCED:  ERRBLK,  FLBLK,  PRCBLK,  STDBLK 

EXTERNAL  REFERENCES:  ABBMV,  ABSMAG,  A'MCONV,  INTABS,  PRECES, 

SC  LASS,  SIGMA 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  IFILE(29i 
is  NAMELIST  /PROCS/  input.  FORTRAN  data  set  reference  number  IFILE(22) 
is  error  message  output. 

ERROR  MESSAGES: 

’ERROR— UNEXPECTED  END  OF  FILE  ON  SUBROUTINE  STAND  NAMELIST.  ’ 
File  IFILE(29)  did  not  contain  NAMELIST  /PROCS/.  UPDATE,  stops. 

’ERROR— SPECTROSCOPIC  PARALLAX  NON-CONVERGENCE  FOR  STAR  HD 
xxxxxxx  = SKYMAP  yyyyyyy  . LAST  DISTANCE  WAS  zzzzzzzz.  z PARSECS.  ’ 
Irrecoverable  error  in  the  spectroscopic  parallax  routine.  Master  Catalog 
Words  57  and  58  are  set  to  zero  for  star  HD  xxxxxxx  = SKYMAP  number 
yyyyyyy-  The  best  estimate  for  the  distance  is  zzzzzzzz.  z. 

'ERROR— SPECTROSCOPIC  PARALLAX  ERROR  COULD  NOT  BE  COMPUTED 
FOR  STAR  HD  xxxxxxx  = SKYMAP  yyyyyyy. 1 The  error  in  the  spectroscopic 
parallax  was  set  to  0.  0 for  star  HD  xxxxxxx  = SKYMAP  number  yyyyyyy-  The 
error  is  irrecoverable. 
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5.3.2.23  Subroutine  SUB  1 

DESCRIPTION:  SUBl  is  a user-supplied  subroutine  to  perform  add/delete  date 
functions.  It  is  called  only  if  ICNT(2,  -J)  = 1 for  some  J,  such  that  1 s J ^ 
NCNT.  See  subroutine  CONTRL  description  (Section  5.3.2. 5)  for  a definition 
of  ICNT  and  NCNT. 

CALLING  SEQUENCE:  Subroutine  SUB1(X,IX) 

COMMON  AREAS  REFERENCED:  FLBLK 
EXTERNAL  REFERENCES:  None 
INPUT /OUTPUT  DATA  SETS:  None 
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5.  3.  2. 24  Subroutine  SUB2 

DESCRIPTION:  SUB2  is  a user-supplied  subroutine  to  perform  add/delete  data 
functions.  It  is  called  only  if  ICNT(2,  J)  = 2 for  some  -J,  such  that  1 £ J ^ 
NCNT.  See  subroutine  CONTRL  description  (Section  5.  3. 2.  5)  for  a definition  of 
IC NT  and  NCNT. 

CALLING  SEQUENCE:  Subroutine  SUB2(X,DC) 

COMMON  AREAS  REFERENCED:  FLBLK 
EXTERNAL  REFERENCES:  None 
INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2. 25  Subroutine  SUB3 

DESCRIPTION:  SUB3  is  a user-supplied  subroutine  to  perform  add/delete  data 
functions.  It  is  called  only  if  ICNT(2,  J)  = 3 for  some  -J,  such  that  1 ^ J ^ 
NCNT.  See  subroutine  CONTRL  description  (Section  5. 3.  2. 5)  for  a definition 
of  ICNT  and  NCNT. 

CALLING  SEQUENCE:  Subroutine  SUB3(X,EX) 

COMMON  AREAS  REFERENCED:  FLBLK 
EXTERNAL  REFERENCES:  None 
INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2. 26  Subroutine  SUB4 

DESCRIPTION:  SUB4  is  a user-supplied  subroutine  to  perform  add/delete  data 
functions.  It  is  called  only  if  ICNT(2,  -J)  = 4 for  some  J,  such  that  1 ^ J ^ 
NCNT.  See  subroutine  CONTRL  description  (Section  5.  3. 2. 5)  for  a definition 
of  ICNT  and  NCNT 

CALLING  SEQUENCE:  Subroutine  SUB4(X,EX) 

COMMON  AREAS  REFERENCED:  FLBLK 
EXTERNAL  REFERENCES:  None 
INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2.27  Subroutine  SUB5 

DESCRIPTION:  SUB5  is  a user-supplied  subroutine  to  perform  add/delete  data 
functions.  It  is  called  only  if  ICNT(2,  J)  = 5 for  some  J,  such  that  1 ^ J ^ 
NCNT.  See  subroutine  CONTRL  description  (Section  5.3.2. 5)  for  a definition 
of  IC NT  and  NCNT. 

CALLING  SEQUENCE:  Subroutine  SUB5(X,IX) 

COMMON  AREAS  REFERENCED:  FLBLK 
EXTERNAL  REFERENCES:  None 
INPUT/OUTPUT  DATA  SETS:  None 


5-66 


input/ output  vahiabi.es  FOR  SUBROUTINE  SUB5 


ORIGINAL  PAGE  fs 
POOR  QUALITY 


SUB  5 


5-67 


ORIGINAL  PAG^!^ 
Of  POOR  QUALITY 


SUB  6 


5.  3.  2. 28  Subroutine  SUB6 

DESCRIPTION:  SUB6  is  a user-supplied  subroutine  to  perform  add/delete  data 
functions.  It  is  called  only  if  ICNT(2,  J)  = 6 for  some  J,  such  that  1 ^ J ^ 
NCNT.  See  subroutine  CONTRL  description  (Section  5. 3. 2. 5)  for  a definition 
of  ICNT  and  NCNT. 

CALLING  SEQUENCE:  Subroutine  SUB6(X,IX) 

COMMON  AREAS  REFERENCED:  FLBLK 
EXTERNAL  REFERENCES:  None 
INPUT/OUTPUT  DATA  SETS:  None 
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5.  3.  2.29  Subroutine  WRITEM 

DESCRIPTION:  Subroutine  WRITEM  is  a user-written  subroutine  to  write  a 
Mission  Catalog. 

CALLING  SEQUENCE:  Subroutine  WRITEM  (X,DC,IKNT) 

COMMON  AREAS  REFERENCED:  FLBLK 
EXTERNAL  REFERENCES:  None 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  IFILE(28) 
is  Mission  Catalog  output. 
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5.  3.  2.  30  Subroutine  ZERO 

DESCRIPTION:  Subroutine  ZERO  sets  Master  Catalog  words  to  their  default 
values. 

CALLING  SEQUENCE:  Subroutine  ZERO  (IDO,  IWORD,  X,  IX) 

COMMON  AREAS  REFERENCED:  None 
EXTERNAL  REFERENCES:  None 
INPUT/OUTPUT  DATA  SETS:  None 
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5.4  COMMON  AREA  DESCRIPTIONS 
5.4.1  COMMON  /ABBLK/ 

DESCRIPTION:  /ABBLK/  contains  the  coefficients  used  to  convert  HD  magni- 
tudes to  the  UBV  system  (see  Section  3.4.2) 

FORM:  COMMON  /ABBLK/  AXX(23),  BXX(23),  BMVXX(23),  AYY(23),  BYY(23) 
REFERENCED  BY:  ABB  MV,  UPDATE 
DEFINITION  OF  VARIABLES: 


Name 

TyPe 

Description 

A XX  (2  3), 
BXX(23), 
UBVXX  (2  3) 

R*4 

A XX (I),  BXX(I),  BMVXX (I) : Parameters 
for  conversion  of  HD  magnitudes  to  UBV 
magnitudes  according  to  the  formulae  of 
Section  3.4.2.  I refers  to  the  spectral 
class  range  from  Table  3-6.  AXX  is  A1 
of  Table  3-7,  BXX  is  A2,  and  BMVXX 
is  (B-V)*  , • 

A YY(23), 

R*4 

Same  as  AXX,  BXX  for  SAO  stars 

BYY  (23) 
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5.4.2  COMMON  /ABSBLK/ 

DESCRIPTION:  /ABSBLK/  contains  absolute  visual  magnitudes  of  stars  as  a 
function  of  spectral  type. 

FORM:  COMMON  /ABSBLK/  AMAG(61,  8) 

REFERENCED  BY:  ABSMAG,  UPDATE 

DEFINITION  OF  VARIABLES: 

Name  Type  Description 

AMAG(61,  8)  R*4  AMAG(I,  -J)  = the  absolute  visual  magni- 

tude for  a star  of  spectral  type  code 
between  1*10  and  1*10-9,  inclusive,  and 
luminosity  class  given  by: 

J Luminosity  Class 

Ia-0 
la 

lab  or  I 
lb 

II 

III 

IV 

V 


1 

O 

3 

4 

5 

6 

7 

8 
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5.4.3  COMMON  /ADDBLK/ 

DESCRIPTION:  /ADDBLK/  contains  star  data  to  be  added  to,  or  deleted  from, 
the  Master  Catalog. 

FORM:  COMMON  /ADDBLK/  DTADD (20,  20) , NDTADD(20) 

REFERENCED  BY:  READNX,  UPDATE 

Description 


For  add/delete  process  number  J, 
DTADD(I,  J)  is  the  value  of  the  Ith  data 
word  to  be  added  (1  ^ I ^ 20) 

For  add/delete  process  J,  NDTADD(J) 
is  the  SKYMAP  number  of  the  star  for 
which  data  is  to  be  added  or  deleted 


DEFINITION  OF  VARIABLES: 
Name  Type 


DTADD (20,  20)  R*4 


NDTADD  (2  0)  1*4 
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5.4.4  COMMON  /CNTBLK/  ’ * ♦ 

DESCRIPTION:  /CNTBLK/  contains  parameters  defining  the  add/delete  data 
processes  to  be  performed  by  UPDATE. 

FORM:  COMMON  /CNTBLK/  ICNT(49,  20),  FCNT(2,  20),  NCNT 
REFERENCED  BY:  CONTRL,  UPDATE 
DEFINITION  OF  VARIABLES: 

Name  Type  Description 

ICNT(49,20)  1*4  For  the  -Jth  add/delete  process: 

ICNT(1,  J)  = NAMELIST  /INSTR/  parameter 
ITY 

ICNT(2,  J)  = NAMELIST  /INSTR/  parameter 
IFL 

ICNT(3,  J)  = NAMELIST  /INSTR/  parameter 
NDEL 

ICNT(4, J),  ICNT(23,J)  = NAMELIST 
/INSTR/  parameters  IDEL(l) 

...  IDEL(20),  respectively 

ICNT(24,  J)  = NAMELIST  /INSTR/  parameter 
NADD 

ICNT (25,  J)  . . . , ICNT(44,  J)  = NAMELIST 
/INSTR/  parameters  L4.DD(1), 

...  IADD(20),  respectively 

ICNT (45,  J)  = NAMELIST  /INSTR/  parameter 
ISUB 

ICNT(46,  J)  = NAMELIST  /'INSTR/  parameter 
IVARTS 

ICNT (47,  J)  = NAMELIST  /INSTR/  parameter 
ITSTYP 

ICNT (48,  J)  = NAMELIST  /INSTR/  parameter 
I LIMA. 

ICNT (49,  J)  = NAMELIST  /INSTR/  parameter 
ILIMB 

For  a description  of  NAMELIST  /INSTR/ 

parameters,  see  Section  5.  5. 1. 1.  2 
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Type  Description 


R*4  For  the  Jth  add/delete  process: 

FCNT(1,  J)  = NAMELIST  /INSTR/  parameter 
FLIMA 

FCNT(2,  J)  = NAMELIST  /INSTR/  parameter 
FLIMB 

For  a description  of  NAMELIST  /INSTR/ 
parameters,  see  Section  5.  5. 1. 1.  2 

1*4  Number  of  add/delete  processes  called  for 
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5.4.5  COMMON  /ERRBLK/ 

DESCRIPTION:  /ERRBLK/  contains  systematic  errors  in  HD  star  positions 
FORM:  COMMON  /ERRBLK/ RAERR(18, 8),DCERR(18, 8) 

REFERENCED  BY:  BLOCK  DATA,  STAND 
DEFINITION  OF  VARIABLES: 

Name  Type  Description 

RAERR(18,8),  R«4  Systematic  errors  in  right  ascension 

DCERR(18, 8)  and  declination,  respectively,  for  HD 

stars.  The  subscripts  (I,  J)  refer  to  a 
region  of  the  sky  as  defined  in 
Section  4.  7. 
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5.4.6  COMMON  /FLBLK/ 

DESCRIPTION:  /FLBLK/  contains  the  FORTRAN  data  set  reference  numbers 
for  UPDATE  input/output  data  sets. 

FORM:  COMMON  /FLBLK/  IFILE(30) 

REFERENCED  BY:  AMCONV,  CONTRL,  PRNTIT,  READNX,  STAND,  SUB1,  SUB2 , 
SUB3,  SUB4,  SUB5,  SUB 6,  UPDATE,  WRITEM 

DEFINITION  OF  VARIABLES: 

Name  Type  Description 

IFILE(30)  1*4  IFILE(I)  = NAMELIST  /FILES/  parameter 

IFILEX(I).  See  Section  5.  5. 1. 1. 1 for  a 
description  of  IFILEX. 
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5.4.7  COMMON  /PRCBLK/ 

DESCRIPTION:  /PRCBLK/  contains  the  flags  directing  execution  of  UPDATE 
standard  processes. 

FORM:  COMMON  /PRCBLK/  IPROC(IOO),  IPART(IO) 

REFERENCED  BY:  AMCONV,  STAND,  UPDATE 


DEFINITION  OF  VARIABLES: 
Name  Type 

IPROC(IOO)  1*4 


IPART(IO)  1*4 


Description 


Standard  process  execution  flag. 

If  IPROC(I)  = 0,  the  Ith  standard  process 
is  not  to  be  performed 

If  IPROC(I)  f 0,  the  Ith  standard  process 
is  to  be  performed 

See  the  NAMELIST/PROCS,  description 

in  Section  5. 5. 1. 1.  3 for  a definition  of 

each  process 

Standard  process  group  flag. 

If  IPART(I)  = 0,  no  standard  processes  in 
group  I are  to  be  per- 
formed 

If  IPART(I)  = 1,  one  or  more  standard 

processes  in  group  I are 
to  be  performed 

1 = 1 refers  to  IPROC(J),  1 £ J ^ 6. 

I = 2 refers  to  IPROC(J),  lis  js  12. 

1 = 3 refers  to  IPROC(J),  21  £ J £ 29. 

I = 4 refers  to  IPROC(J),  31  * J £ 41. 

1 = 5,  . . . , 10  are  not  used 
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5.4.8  COMMON /PRTBLK/ 

DESCRIPTION:  /PRTBLK/  contains  the  instructions  to  UPDATE  which  control 
printed  output. 

FORM:  COMMON  /'PRTBLK/  IFST,  IWRT,  ICTY,  ICTY2,  ITYPRT.IFLPRT(IO), 
ICOND,  ICMN,ICMX,  FCMN,  FCMX.ICOND2,  ICMN2,  ICMX2,  FCMN2,  FCMX2, 
LINES, ILNTOT(IOO),  ILNIVILT(IOO),  IUNIQ(IO) 

REFERENCED  BY:  PRNTIT,  UPDATE 

DEFINITION  OF  VARIABLES: 


Name 

Type 

Description 

IFST 

1*4 

First  call  flag.  If  IFST  * 0,  this  is  the 
first  call  to  PRNTIT.  PRNTIT  then 
reads  NAMELIST  /XPRINT/  and  sets 
IFST  = 0.  If  IFST  = 0,  this  is  not  the 
first  can  to  PRNTIT 

IWRT 

1*4 

File  number  for  printed  output 

ICTY 

1*4 

Master  Catalog  word  number  of  the  first 
conditional  variable 

ICTY2 

1*4 

Master  Catalog  word  number  of  the 
second  conditional  variable 

ITYPRT 

1*4 

Same  as  NAMELIST  /XPRINT/  word 
JTYPRTl 

IFLPRT(IO) 

1*4 

Same  as  NAMELIST  /XPRINT/  words 
JFLPRT1 

ICOND 

1*4 

Same  as  NAMELIST  /XPRINT/  word 
JCONDl 

ICMN 

1*4 

Same  as  NAMELIST  /XPRINT/  word 
JCMN1 

ICMX 

1*4 

Same  as  NAMELIST  /XPRINT/  word 
JCMX1 

FCMN 

R*4 

Same  as  NAMELIST  /XPRINT/  word 
GCMN1 

1See  Section  5.  5. 1. 1.4  for  a definition  of  NAMELIST  /XPRINT/  variables. 
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Name 

Type 

Description 

FCMX 

R*4 

Same  as  NAMELIST  /XPRINT/  word 
GCMX1 

ICOND2 

1*4 

Same  as  NAMELIST  /XPRINT/  word 
JCOND21 

ICMN2 

1*4 

Same  as  NAMELIST  /XPRINT/  word 
JCMN21 

ICMX2 

1*4 

Same  as  NAMELIST  /XPRINT/  word 
JCMX21 

FCMN2 

R*4 

Same  as  NAMELIST  /XPRINT/  word 
GCMN21- 

FCMX2 

R*4 

Same  as  NAMELIST  /XPRINT/  word 
GCMX21 

LINES 

1*4 

Same  as  NAMELIST  /'XPRINT/  word 
LINESXl 

ILNTOT(IOO) 

1*4 

ILNTOT(I)  = total  number  of  lines  output 
• to  FORTRAN  data  set  refer- 

ence number  I 

ILNMLT(IOO) 

1*4 

ILNMLT(I)  = number  of  lines  of  data  per 
star  output  to  FORTRAN 
data  set  reference  number  I 

IUNIQ(IO) 

1*4 

The  unit  uniqueness  flag: 

IUNIQ(I)  = 0,  IFLPRT(I)  = IFLPRT(J)  for 

J<  I 

IUNIQ(I)  = 1,  IFLPRT(I)  = IFLPRT(J)  for 
any  J<  I 


1 


See  Section  5.  5. 1. 1.4  for  a definition  of  NAMELIST  /IXPRINT 


variables. 
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5.4.9  COMMON  /SIGBLK/ 

DESCRIPTION:  /SIGBLK/  contains  the  mean  standard  deviation  in  stellar 
space  velocity  components  as  a function  of  spectral  type. 

FORM:  COMMON  /SIGBLK/  3IG1(13),  SIG2(13),  SIG3(13) 

REFERENCED  BY:  SIGMA,  UPDATE 


DEFINITION  OF  VARIABLES: 
Name  Type 


SIG1(13),  R*4 

SIG2(13) , 

SIG3(13) 


Description 


SIG1(I),  SIG2(I),  SIG3(I)  = the  mean  stand- 
ard deviation  for  the  9,  tt,  and  z space 
velocity  components,  respectively,  for 
the  range  of  spectral  class  and  luminosity 
class  given  in  column  1 of  Table  3-9 
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DESCRIPTION:  /STDBLK/  contains  the  standard  intrinsic  B-V  and  U-B  colors 
as  a function  of  spectral  class  and  luminosity  class. 

FORM:  COMMON  /STDBLK/BMVSTD(66,  5),  UMBSTD(66,  5) 

REFERENCED  BY:  STAND,  UPDATE 


DEFINITION  OF  VARIABLES: 
Name  Type 


BMVSTD(66, 5)  R*4 

UMBSTD(66,  5) 


Description 


BMVSTD(I,  J),  UMBSTD(I,  J)  = standard  un- 
reddened B-V  and  U-B  color,  respectively, 
for  a star  of  spectral  class  code  10*1  and 
luminosity  class  code  10 *J 
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5.5  USER'S  MANUAL 

This  subsection  will  enable  the  user  to  create  the  proper  NAMELIST  and  data 
set  input,  write  selected  code  to  handle  special  cases,  interpret  the  resulting 
output,  and  formulate  the  appropriate  Job  Control  Language  (JCL)  for  program 
UPDATE. 

5.5.1  Input  to  Program  Update 

Input  to  UPDATE  consists  of  several  NAMELISTs,  optional  data  sets,  and  op- 
tionally one  or  more  user-written  subroutines. 

5.  5. 1. 1 NAMELIST  Input 

The  user  may  code  input  data  into  program  UPDATE  via  NAMELISTs  FILES, 
INSTR,  PROCS,  and  XPRINT.  The  NAMELIST  parameters  are  presented  below 
in  the  format  stated  in  Section  2.4.3. 

FILES  is  always  read  first  from  FORTRAN  data  set  reference  number  5. 

INSTR  is  always  read  next  from  FORTRAN  data  set  reference  number 
IFILE(23).  INSTR  is  read  repeatedly  until  an  end  of  file  is  encountered.  If 
standard  processes  are  to  be  performed,  PROCS  is  read  next  from  FORTRAN 
data  set  number  IFILE(29).  If  printed  output  is  to  be  generated,  XPRINT  is 
then  read  from  FORTRAN  data  set  reference  number  IFILEC27).  Except  for 
INSTR,  multiple  NAMELISTs  are  not  processed  by  UPDATE. 
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&FILES 


NAMELIST  /FILES/ 


Type  Default 


Description 


1*4  10,  11,  12,  13,  14, 

15,  16,  17,  18,  19, 

20,  21,  22,  23,  24, 

25,  26,  27,  28,  29, 

5,  6,  4,  40,  50,  60, 
35,  70,  3,  0 


IFILEX(I),  1 £ I £ 20  = file  num- 
ber for  the  Ith  add/delete  data 
set 

IFILEX(21)  = not  used 

IFILEX(22)  = file  number  for 
error  message  and  program  trace 
printed  output 

IFILEX(23)  = file  number  for 
NAMELIST  /INSTR/  input 

IFILEX(24)  = file  number  for 
Master  Catalog  input 


IFILEX(25)  = file  number  for 
Master  Catalog  output 

IFILEX(26)  = file  number  for 
printed  log  output 

IFILEX(27)  = file  number  for 
NAMELIST  /XPRINT/  input.- 

IFILEX(28)  = file  number  for 
Mission  Catalog  output 

IFILEX(29)  = file  number  for 
NAMELIST  /PROCS/  input 


1*4  0 


IFILEX(30)  = not  used 
Print  flag 

= 0,  do  not  print  star  data 
= 1,  print  star  data 


1*4  o Master  Catalog  output  flag 

= 0,  do  not  output  Master  Catalog 
= 1,  output  Master  Catalog 

1*4  0 Mission  Catalog  output  flag 

= 0,  do  not  call  subroutine 

WRITEM  to  output  Mission 
Catalog 

= 1,  call  subroutine  WRITEM  to 
output  Mission  Catalog 
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Name 

Type 

Default 

Description 

IFSTND 

1*4 

0 

Standard  processes  call  flag 

= 0,  do  not  perform  standard 
processes 


= 1,  perform  requested  standard 
processes  only  for  stars 
added  to  the  Master  Catalog 
during  the  current  run 
= 2,  perform  requested  standard 
processes  only  for  stars 
added  to  the  Master  Catalog, 
and  for  stars  with  data  added 
during  the  current  run 
= 3,  perform  requested  standard 
processes  for  all  Master 
Catalog  stars 
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o*  o • 1.1.2 
Name 
ITY 


IFL 

NDEL 

IDEL(20) 

NADD 

IADD(20) 

ISUB 

IV  A RTS 

ITSTYP 


NAMELIST  /INSTR/ 

Type  Default 

1*4  0 


1*4  0 

1*4  0 

1*4  20*0 


1*4  0 

1*4  20*0 


1*4 


1 


1*4 


0 


1*4  1 


Description 


Type  of  process  to  be  performed 
= 0,  none 
= 1,  add  stars 
= 2,  delete  stars 
= 3,  delete  data  for  a star 
= 4,  add  data  for  a star 
= 5,  predefined  process  for  all 
stars 

= 6,  predefined  process  for  stars 
stars  passing  conditional 
test  only 

Input  file  number  for  add/delete 
process  data 

Number  of  words  of  data  to  be 
deleted  (ITY  = 3 only) 

Master  Catalog  word  numbers 
of  words  of  data  to  be  deleted 
(ITY  = 3 only) 

Number  of  words  of  data  to  be 
added  (ITY  = 1 or  4 only) 

Master  Catalog  word  numbers 
of  words  of  data  to  be  added 
(ITY  = 1 or  4 only) 

Call  subroutine  SUBX,  where  X 
is  replaced  by  the  value  of  ISUB 
to  be  called  (ITY  = 5 or  6 only) 

Master  Catalog  variable  number 
of  the  conditional  variable 
(ITY  = 6 only) 

Type  of  conditional  variable 
= 1,  conditional  variable  is  1*4 
= 2,  conditional  variable  is  R*4 
(ITY  = 6 only) 
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Name 

Type 

Default 

ILIMA, 

ILIMB 

1*4 

0,  0 

FLIMA, 

FLEVIB 

R*4 

0.0,  0, 

Description 


Limits  for  conditional  variable. 
Perform  predefined  process  only 
if  the  value  of  Master  Catalog 
word  IV ARTS  is  greater  than  or 
equal  to  ILIMA  and  less  than  or 
equal  to  ILIMB  (ITY  = 6 and 
ITSTYP  = 1 only) 

Limits  for  conditional  variable. 
Perform  predefined  process  only 
if  the  value  of  Master  Catalog 
word  IV ARTS  is  greater  than  or 
equal  to  FLIMA  and  less  than 
or  equal  to  FLIMB  (ITY  = 6 and 
ITSTYP  = 2 only) 
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&PROCS 


Name 

Type 

Default 

Description 

JPROC(IOO) 

1*4 

100*0 

Standard  process  flags 
JPROC(I)  = 0,  do  not  perform 
the  Ith  standard 
process 

JPROC(I)  r 0,  perform  the  Ith 
*»•  standard  process 

Table  5-1  summarizes  the  standard  processes. 
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5.  5. 1.1.4  NAMELIST /XPRINT/ 


Name 

Type 

Default 

Description 

JTYPRT 

1*4 

1 

Type  of  printed  output 
= 1,  one  page  summary 
= 2,  full  scientific 
See  Section  5. 5. 2.  3. 3 for  a de- 
scription of  these  outputs 

JFLPRT(IO) 

1*4 

10*0 

jt'LPRTfl)  = file  number  for  the 
Ith  page  of  printed  output 

JCOND, 

JCOND2 

1*4 

0,  0 

Master  Catalog  word  number 
for  the  first  and  second  condi- 
tional variables.  If  = 0,  not 
processed 

JCMN, 

JCMX, 

JCMN2, 

JCMX2 

1*4 

# 

o o 
o o 

Minimum  and  maximum  values 
of  the  first  and  second  condi- 
tional variables,  respectively, 
that  result  in  data  from  the  star 
being  printed  (JCOND  and/or 
JCOND2  4 0 and  Master  Catalog 
word  JCOND  and/or  JCOND2 
being  1*4  only) 

GCMN, 

GCMX, 

GCMN2, 

GCMX2 

R*4 

0.0,  0.0 

0.  0,  0. 0 

Minimum  and  maximum  values 
of  the  first  and  second  condi- 
tional variables,  respectively, 
that  result  in  data  from  the  star 
being  printed  (JCOND  and/or 
JCOND2  ^ 0 and  Master  Catalog 
word  JCOND  and/or  JCOND2 
being  R*4  onl}'') 

LINESX 

1*4 

80 

Maximum  number  of  lines  of 

output  to  be  printed  on  one  page 
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5.  5. 1. 2 Data  Set  Input 

All  or  selected  star  data  words  may  be  added  to,  or  deleted  from,  the  Master 
Catalog  using  the  add/delete  processes.  NAMELIST  /INSTR/  contains  the 
control  parameters  defining  the  flow  of  this  segment  of  UPDATE  (see  Section 
tion  5. 5. 1. 1.  2).  The  star  data  to  be  added  and  the  star  numbers  for  deleting 
data  or  stars  are  read  from  data  sets.  For  the  Ith  add/delete  process,  the 
associated  data  set  is  on  file  ICNT(2,I)  in  COMMON  /CNTBLK/. 

The  format  of  the  input  data  sets  is  the  same  for  all  processes  and  consists  of 
one  4-byte  integer  followed  by  twenty  4-byte  floating  point  words  per  logical 
record.  The  integer  is  the  SKYMAP  number  of  the  star  to  be  processed,  except 
for  add  star  processes,  when  it  is  the  SKYMAP  number  of  the  star  following 
which  the  new  star  is  to  be  added.  For  add  star  or  add  data  processes,  the 
next  floating  point  NADD  (a  NAMELIST  /INSTR/  parameter)  words  are  the 
values  for  Master  Catalog  word  numbers  IADD(J),  J = 1,  . . . , NADD  (IADD  is 
also  a NAMELIST  /INSTR/  parameter).  For  delete  star  or  delete  data  proc- 
esses, the  floating  point  words  are  meaningless. 

Each  input  data  set  must  be  ordered  by  increasing  SKYMAP  number.  Failure 
to  do  so  may  result  in  some  stars  not  being  processed. 

For  add  star  processes,  the  SKYMAP  number  of  the  star  must  be  one  of  the 
Master  Catalog  data  words  added.  Any  data  word  not  specifically  added  will  be 
set  to  its  default  value  (see  Table  4-1). 

5. 5. 1. 3 User-Written  Subroutines 

5. 5. 1.3.1  Subroutines  SUB1,  SUB2,  SUB3,  SUB4,  SUBS,  and  SUB6 

The  user  may  code  up  to  six  subroutines  to  perform  predefined  processes. 

These  subroutines  are  called  subject  to  logic  provided  in  the  add/delete  process 
NAMELIST  /INSTR/  (see  Section  5.  5. 1. 1.2).  Whenever  indicated  by  ITY  (a 
NAMELIST /INSTR /parameter),  SUB1,  SUB 2,  SUB 3,  SUB4,  SUBS,  or  SUBS  is 
called. 
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Dummy  versions  of  these  subroutines  are  provided  in  UPDATE.  These  are  all 
of  the  following  form: 

SUBROUTINE  SUBy  (X,  IX) 

COMMON  /FLBLK/  IFILE(30) 

DIMENSION  X(135),  IX (13 5) 

RETURN 

END 

where  y is  an  integer  between  1 and  6.  X,  IX,  and  IFILE  are  defined  in 
Sections  5.3.2.23  to  5.3.2.28. 

5.  5. 1.3.2  Subroutine  WRIT  EM 

The  user  may  code  subroutine  WRITEM  to  output  a Mission  Catalog  in  any  for- 
mat he  desires.  The  Mission  Catalog  output  must  always  be  to  file  IFILE (28) 

(a  COMMON  /FLBLK/  parameter).  A dummy  version  of  this  routine  is  pro- 
vided in  UPDATE  as  follows: 

SUBROUTINE  WRITEM  (X,  IX,  IKNT) 

DIMENSION  X (135),  DC(135),  DX4 
COMMON  /FLBLK/  IFILE (30) 

IKNT  = IKNT  4-  1 

RETURN 

END 

X,  IX,  and  IFILE  are  defined  in  Section  5.3.2.29.  IKNT  is  an  output  record 
counter  whose  value  is  set  to  0 at  the  start  of  execution. 

5.5.2  Output  From  Program  UPDATE 

5.  5. 2. 1 Output  Master  Catalog 

Whenver  the  NAMELIST  /FILES/  parameter  IFMAST  is  not  equal  to  zero,  a 
Master  Catalog  is  output  on  file  IFILE (25)  (a  COMMON  /FLBLK/  parameter). 


5-96 


ORIGINAL  PAGE  IS 
OF  POOR  QUALITY 

The  format  of  the  output  Master  Catalog  is  identical  to  that  of  the  input  Master 
Catalog  (see  Section  4).  All  additions,  deletions,  and  changes  of  data  accom- 
plished by  UPDATE  are  present  on  the  output  Master  Catalog.  Because  of  this, 
there  is  no  guarantee  that  the  output  Master  Catalog  will  be  in  order  by  SKYMAP 
number.  If  it  is  not,  subsequent  executions  of  UPDATE  may  not  accomplish 
the  desired  results. 

5.  5.  2. 2 Mission  Catalog 

Whenever  the  NAMELIST  /FILES/  parameter  IFMISS  is  not  equal  to  zero,  user- 
written  subroutine  WRITEM  is  called  in  which  the  user  may  code  the  output  of  a 
Mission  Catalog  on  file  IFILE(28).  (IFILE  is  a COMMON  /FLBLK/  parameter.) 

5. 5.  2. 3 Printed  Output 

Trace  message  and  error  message  output  appear  on  file  IFILE(22)  (IFILE  is  a 
COMMON  /FLBLK/  parameter);  log  output  is  written  to  file  IFILE(26);  and  a 
printed  version  of  the  catalog  is  output  on  files  JFLPRT(l),  . . . , -JFLPRT(k), 
where  JFLPRT  is  a NAMELIST  /XPRINT/  parameter  and  k depends  on  the  value 
of  JTYPRT  (also  a NAMELIST  /XPRINT/  parameter).  For  JTYPRT  = 1,  k = 1; 
and  for  JTYPRT  = 2,  k = 6. 

5. 5. 2. 3. 1 Trace  Message  Output 

UPDATE  produces  a small  amount  of  trace  message  output  to  inform  the  user 
of  progress  through  the  program.  No  user  action  is  necessary  based  on  this 
output,  but  it  can  be  used  to  assist  in  tracking  down  problems  encountered  with 
UPDATE. 

5. 5.  2.  3. 2 Error  Message  Output 

UPDATE  produces  error  message  output  for  a number  of  anomalous  situations. 
These  are  listed  below,  together  with  an  explanation  of  the  cause  of  the  message 
and  what  user  action  is  indicated.  Each  error  message  is  preceded  by  either 
the  word  "ERROR"  or  "WARNING. " Messages  preceded  by  "ERROR"  cause 
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a stop  to  be  executed.  Messages  preceded  by  "WARNING”  cause  the  action 
specified  to  be  taken,  but  execution  continues. 

• Error  Messages  From  UPDATE 

'END  OF  FILE  ON  NAMELIST  FILE  5. ' No  NAMELIST /FILES/ 
was  found  on  unit  5.  One  must  be  supplied. 

'WARNING— FOR  THE  xxTH  PROCESS,  THE  INPUT  DATA  SET  FILE 
NUMBER  yy  is  EMPTY. ' The  data  set  (on  file  number  yy)  for  the 
xxth  add/delete  process  was  empty.  UPDATE  ignores  this  add/delete 
instruction. 

'WARNING— FOR  THE  xxTH  PROCESS,  A STAR  TO  BE  DELETED 
(yyyyyy)  IS  NOT  IN  THE  MASTER  CATALOG'  where  xx  is  the  num- 
ber of  the  add/delete  process  and  yyyyyy  is  the  SKYMAP  number  of 
the  star  to  be  deleted.  UPDATE  ignores  this  delete  instruction. 

Note  that  delete  records  not  being  in  numerical  order  of  SKYMAP 
number  may  cause  this  error. 

'WARNING— FOR  THE  xxTH  PROCESS,  A STAR  WITH  DATA  TO 
BE  DELETED  (yyyyyy)  IS  NOT  IN  THE  MASTER  CATALOG'  where 
xx  is  the  number  of  the  add/delete  process  and  yyyyyy  is  the 
SKYMAP  number  of  the  star  with  data  to  be  deleted.  UPDATE 
ignores  this  delete  data  instruction.  Note  that  delete  data  records 
not  being  in  numerical  order  of  SKYMAP  number  may  cause  this 
error. 

'WARNING— FOR  THE  xxTH  PROCESS,  A STAR  WITH  DATA  TO 
BE  ADDED  (yyyyyy)  IS  NOT  IN  THE  MASTER  CATALOG'  where 
xx  is  the  number  of  the  add/delete  process  and  yyyyyy  is  the 
SKYMAP  number  of  the  star  with  data  to  be  added.  UPDATE  ig- 
nores this  add  data  instruction.  Note  that  add  data  records  not 
being  in  numerical  order  of  SKYMAP  number  may  cause  this  error. 
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• Error  Messages  From  Subroutine  CONTRL 

'WARNING— ITY  INDICATES  A NULL  PROCESS  OR  AN  UNDEFINED 
PROCESS.  ITY  = xxx.  ' ITY  was  equal  to  xxx.  Only  values  between 
1 and  6 are  meaningful.  UPDATE  ignores  this  add/delete  process. 

'ERROR— FOR  THE  xxTH  PROCESS,  THE  FILE  DEFINED  yy  IS 
ALREADY  IN  USE. ' The  input  file  (yy)  for  the  xxth  add/delete  proc- 
ess was  previously  defined  as  a NAMELIST  read,  printed  output  or 
Master  Catalog  input  file,  or  as  an  input  file  for  a previous  add/delete 
process.  Change  the  duplicated  file  number.  UPDATE  stops. 

'WARNING— FOR  THE  xxTH  PROCESS— A DELETE  DATA  PROCESS, 
NDEL  (yyyyyyyy)  WAS  NOT  POSITIVE.  ’ For  add/delete  process 
number  xx,  the  number  of  data  words  to  be  deleted  (yyyyyyyy)  was 
not  positive.  UPDATE  ignores  this  process. 

'ERROR— FOR  THE  xxTH  PROCESS,  NDEL  (yyyyyyyy)  WAS 
LARGER  THAN  THE  LIMIT,  20. ' For  add/delete  process  num- 
ber xx,  the  number  of  data  words  to  be  deleted  was  greater  than 
the  maximum  allowed,  20.  UPDATE  stops. 

'ERROR— FOR  THE  xxTH  PROCESS,  THE  yyTH  WORD  TO  BE 
DELETED  IS  AN  ILLEGAL  VALUE— zzzz'  For  add/delete  process 
number  xx,  the  yyth  word  to  be  deleted  lies  outside  of  the  limits 
1 £ zzzz  £ 131.  UPDATE  stops. 

'WARNING— FOR  THE  xxTH  PROCESS,  AN  ADD  DATA  PROCESS, 
NADD  (yyyyyyyy)  WAS  NOT  POSITIVE.  ’ For  add/delete  process 
number  xx,  the  number  of  words  of  data  to  be  added,  yyyyyyyy,  was 
not  positive.  UPDATE  ignores  this  add/delete  process. 
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'ERROR— FOR  THE  xxTH  PROCESS,  NADD  (yyyyyyyy)  WAS  LARGER 
THAN  THE  LIMIT,  20. 1 For  add/delete  process  number  xx,  the 
number  of  data  words  to  be  added  was  greater  than  the  maximum 
allowed,  20.  UPDATE  stops. 

'ERROR— FOR  THE  xxTH  PROCESS,  THE  yyTH  WORD  TO  BE 
ADDED  IS  AN  ILLEGAL  VALUE — zzzz'  For  add/delete  process 
number  xx,  the  yyth  word  to  be  added  lies  outside  of  the  limits 
1 ^ zzzz  ^ 131.  UPDATE  stops. 

'ERROR— FOR  THE  xxTH  PROCESS,  THE  SUBROUTINE  NUMBER 
SPECIFIED  (yyyyyyyy)  IS  AN  ILLEGAL  VALUE.  ’ For  add/delete 
process  xx,  the  subroutine  number  to  be  called  must  be  1 s 

yyyyyyyy  ^ 6.  update  stops. 

'ERROR— FOR  THE  xxTH  PROCESS,  THE  CONDITIONAL  VARI- 
ABLE, IVARTS,  IS  yyyyyyyy,  AN  ILLEGAL  VALUE.  ’ For  add/ 
delete  process  number  xx,  the  variable  to  be  tested  for  conditional 
application  of  the  process  is  not  within  the  allowed  range 

1 s yyyyyyyy  2 131.  update  stops. 

'ERROR— FOR  THE  xxTH  PROCESS,  ITSTYP  = yyyyyyyy,  WHICH 
DOES  NOT  AGREE  WITH  THE  FORMAT  OF  MASTER  CATALOG 
WORD  zzzz. ' For  add/delete  process  number  xx,  the  type  of  the 
conditional  variable  was  yyyyyyyy,  which  does  not  agree  with  the 
Master  Catalog  data  type  for  word  zzzz.  UPDATE  stops. 

'error— for  the  xxTH  process,  itstyp  = yyyyyyyy,  AN 
ILLEGAL  VALUE. ' For  add/delete  process  number  xx,  the  type 
of  conditional  variable  was  yyyyyyyy,  which  is  outside  of  the  al- 
lowed range  1 ^ yyyyyyyy  2 2.  UPDATE  stops. 

’WARNING— OVER  20  PROCESSES  CALLED  FOR. ' Only  20  add/ 
delete  processes  are  allowed.  Any  over  that  amount  are  ignored. 
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• Error  Messages  From  Subroutine  PKNTIT 

'ERROR— AN  END  OF  FILE  WAS  ENCOUNTERED  ON  THE 
NAME  LIST /XPRINT /FILE.  PRINTOUT  IS  CANCELED. ' File 
IFILE  (27)  does  not  contain  NAME  LIST  /XPRINT  /.  No  printout  is 
generated. 

'ERROR— THE  CONDITIONAL  PRINT  VARIABLE,  ICOND,  HAS 
AN  ILLEGAL  VALUE  (xxxxxx).  PRINTOUT  IS  CANCELED.'  The 
first  conditional  print  variable  must  be  a Master  Catalog  word. 
Accordingly,  it  must  satisfy  the  conditions /'xxxxxx /s  131  or 
1001s  xxxxxxs  1004.  No  printout  is  produced. 

'ERROR— THE  CONDITIONAL  PRINT  VARIABLE,  ICOND2,  HAS 
AN  ILLEGAL  VALUE  (xxxxxx).  PRINTOUT  IS  CANCELED. ' The 
second  conditional  print  variable  must  be  a Master  Catalog  word. 
Accordingly,  it  must  satisfy  the  conditions /xxxxxx  / s 131  or 
1001  s xxxxxx  s 1004.  No  printout  is  produced. 

• Error  Messages  From  Subroutine  STAND 

'ERROR— UNEXPECTED  END  OF  FILE  ON  SUBROUTINE  STAND 
NAME  LET. ' File  IFILE  (29)  did  not  contain  NAME  LIST  /PROCS  /. 
UPDATE  stops. 

'ERROR— SPECTROSCOPIC  PARALLAX  NON-CONVERGENCE  FOR 
STAR  HO  xxxxxxx  = SKY  MAP  yyyyyyy.  LAST  DISTANCE  WAS 
zzzzzzzz.z  PARSECS.'  Irrecoverable  error  in  the  spectroscopic 
parallax  routine.  Master  Catalog  words  57  and  58  are  set  to  zero 
for  star  HO  xxxxxxx  = SKYMAP  number  yyyvyyy*  The  best  esti- 
mate for  the  distance  is  zzzzzzzz.  z. 
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'ERROR— SPECTROSCOPIC  PARALLAX  ERROR  COULD  NOT  BE 
COMPUTED  FOR  STAR  HD  xxxxxxx  = SKYMAP  yyyyyyy. ' The  error 
in  the  spectroscopic  parallax  was  set  to  0.  0 for  star  HD  xxxxxxx  = 

SKYMAP  number  yyyyyyy.  The  error  is  irrecoverable. 

5.  5.  2.  3.  3 Printed  Catalog  Output 

Whenever  NAMELIST  /FILES/  parameter  IFPRNT  is  not  equal  to  zero,  a 
printed  version  of  Master  Catalog  data  is  generated  in  accordance  with  the 
instructions  given  in  NAMELIST  /XPRINT/.  Two  standard  formats  are  avail- 
able: a one-page  summary  (Figure  5-3)  or  a six-page  full  scientific  output 
(Figure  5-4). 

5.5.3  Job  Control  Language 

UPDATE  may  be  run  from  a FORTRAN  source  or  a load  module.  The  JCL 
shown  in  Figure  5-5  assumes  that  UPDATE  is  being  run  from  a cataloged 
source  data  set  named  UPDATE.  FORT.  The  input  Master  Catalog  is  assumed 
to  be  on  tape.  All  file  numbers  are  assigned  their  default  values. 

5.5.4  Overlay  Considerations 

Most  of  the  core  storage  required  by  UPDATE  is  for  input/output  buffers  and 
for  a few  large  subroutines  which  are  called  repeatedly  by  UPDATE.  There- 
fore, overlay  procedures  would  be  unable  to  substantially  reduce  core  require- 
ments. 

5.5.5  System  Resources 

UPDATE  requires  300K  bytes  of  core  storage  for  the  compile  step  and  390K 
bytes  for  execution.  Tape  and  data  set  requirements  vary  according  to  the  func- 
tion to  be  performed;  however,  the  input  Master  Catalog  always  requires  one 
nine-track  tape  drive. 
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Figure  f>-3.  Printed  One-Page  Summary  Output  From  Program  UPDATE 
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Figure  5—1.  Printed  Full  Scientific  Output  From  Program  UPDATE  (5  ol  G) 
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Figure  5-4.  Printed  Full  Scientific  Output  From  Program  UPDATE  (0  of  G) 


//  EXEC  FORTRANH, REGION=  300K 

//SYSIN  DD  DSN^UPDATE. FORT, DI SP=SHR 

//  EXEC  LOADER, REGION=390K, PARM= 'SIZE=350000' 

//FT03F001  DD  DSN=NAMELI ST. PROCS . CNTL, DI SP=SHR 

NAMEL IST/PROCS/  DATA  CARDS  GO  HERE 
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IN  THE  USER  SUPPLIED  SUBROUTINE  WRITEM. 
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5.5.6  Execution  Time  Estimates 

Because  of  the  wide  variety  of  functions  performed  by  UPDATE,  it  is  impos- 
sible to  give  accurate  execution  time  estimates.  Normally,  however,  UPDATE 
is  Central  Processing  Unit  (CPU)  bound.  For  example,  a job  which  writes  an 
output  Master  Catalog  and  prints  Master  Catalog  data  in  the  full  scientific 
format  will  require  approximately  2 minutes  CPU  and  0.5  minute  I/O  on  the 
S/360-95  computer  per  10,  000  stars  processed.,. 


5-111 


ORIGINAL  PAGE  18 
OF  POOR  QUALITY 


SECTION  6 - THE  RUN  CATALOG 


The  Run  Catalog  is  the  interface  star  catalog  used  by  attitude  determination 
programs.  It  is  created  by  program  CAT,  usually  on  tape  in  sequential  format, 
using  the  Mission  Catalog  (or  Master  Catalog,  if  necessary)  as  input.  It  is 
transferred  to  direct- access  disk  storage  for  use  by  attitude  determination 
programs  by  program  SWITCH.  The  Run  Catalog^  may  also  be  created  as  a 
direct-access  disk  data  set  by  CAT,  thereby  bypassing  SWITCH.  This  section 
discusses  the  generation  of  the  Run  Catalog  by  program  CAT. 

6. 1 RUN  CATALOG  REQUIREMENTS 

This  section  discusses  the  requirements  placed  upon  the  Run  Catalog  by  the 
programs  that  will  use  it. 

The  minimum  data  required  for  each  star  are  the  star  number  (for  identification), 
and  its  position  as  a geocentric  inertial  unit  vector.  Although  not  explicitly 
required  by  SKYMAP  programs  or  subroutines,  an  instrumental  magnitude  is 
also  normally  included. 

6.1.1  Data  Quality 

The  position  accuracy  which  is  specified  for  Run  Catalog  data  is  dependent  on 
both  the  required  accuracy  and  the  available  accuracy  of  the  current  data.  The 
available  accuracy  of  0.5  arc-second  for  most  stars  (see  Section  3)  is  also  the 
limiting  accuracy  of  a 4-byte  word.  Double  precision  position  data  would  in- 
crease disk  and  core  storage  requirements  by  as  much  as  75  percent  without 
substantially  increasing  accuracy.  Therefore,  0.5  arc-second  has  been  chosen 
as  the  goal  for  the  Run  Catalog.  Approximately  1 percent  of  the  Master  Catalog 
stars  have  positions  with  inaccuracies  of  about  1 arc-minute.  These  stars  are 
flagged  in  the  Master  Catalog  so  that  they  can  be  eliminated  from  consideration 
if  the  user  chooses  to  do  so. 
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Like  positional  accuracy,  the  specified  accuracy  of  the  instrumental  magnitude 
depends  both  on  what  is  desirable  from  the  user's  point  of  view  and  what  is 
attainable.  The  accuracy  of  the  available  data  leads  to  instrumental  magnitudes, 
for  BBRC-type  star  cameras,  with  mean  errors  of  about  ±0. 1 for  50  percent  of 
the  stars  in  the  Master  Catalog,  and  approximately  ±0.3  magnitude  for  the  rest 
(see  Section  3). 

The  user's  accuracy  requirements  result  from  the  difficulty  of  identifying 
observed  stars  with  their  catalog  counterparts.  This  problem  in  pattern  match- 
ing is  made  more  difficult  if  the  star  catalog  contains  more  candidate  stars 
than  the  camera  is  capable  of  detecting.  The  excess  stars  increase  the  number 
of  mismatches  while  not  increasing  the  number  of  true  matches. 

Stars  may  be  eliminated  from  consideration  by  pattern  matching  routines  if 
their  instrumental  magnitudes  are  dimmer  than  the  instrument  threshold  mag- 
nitude. The  number  of  excess  stars  in  the  catalog  is  a function  of  the  magnitude 
tolerance  that  must  be  applied  to  account  for  errors  in  catalog  magnitudes  and 
the  instrumental  threshold.  Because  in-flight  calibration  may  reduce  instru- 
mental threshold  errors  to  below  0. 1 magnitude  (Reference  1),  catalog  errors 
of  no  more  than  ±0. 1 magnitude  are  desirable.  The  full  attainable  accuracy  of 
0. 1 magnitude  is  therefore  the  goal  for  the  Run  Catalog.  Whenever  more  accu- 
rate data  are  available,  the  high  accuracy  is  retained.  When  only  lesser  quality 
data  exist,  it  is  used  but  the  results  are  flagged  in  the  Master  Catalog. 

Incompleteness  in  the  catalog  means  that  some  stars  observed  by  the  star  cam- 
era will  not  be  identifiable  with  catalog  stars;  this  also  makes  star  identification 
more  difficult.  Therefore,  a further  requirement  placed  on  the  Run  Catalog  data 
is  that  it  be  as  complete  as  possible  down  to  a specified  instrumental  magnitude 
limit. 

6.1.2  Data  Organization 

The  requirements  on  the  Run  Catalog  discussed  so  far  concern  the  nature  of 
the  data  it  contains.  Since  the  Run  Catalog  obtains  its  data  from  the  Mission  or 
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Master  Catalog  (or  a user-input  catalog),  these  requirements  do  not  affect  pro- 
gram CAT,  except  that  CAT  must  do  nothing  to  degrade  the  data  beyond  the 
specified  limits.  The  following  requirements  on  the  Run  Catalog  deal  with  the 
format  of  the  catalog,  which  does  directly  affect  the  design  of  CAT. 

The  major  requirement  of  the  Run  Catalog  format  is  that  it  allow  access  by 
attitude  determination  programs  with  minimum  use  of  computer  time  and  core 
storage.  Disk  storage  requirements  should  also -be  minimized. 

In  addition,  to  provide  the  flexibility  needed  to  analyze  data  across  a spacecraft 
slew,  or  when  the  motion  of  the  spin  axis  is  large  or  unpredictable,  the  Run 
Catalog  is  designed  so  that  programs  can  function  property  even  if  the  attitude 
of  the  spacecraft  changes  substantially  during  a single  computer  run. 

For  a typical  BBRC  camera,  the  total  Run  Catalog  will  contain  approximately 
21,000  stars.  For  most  applications,  programs  will  require  at  least  20  bytes 
of  data  per  star  (star  numbe'r,  the  three  components  of  the  star  unit  vector  in 
geocentric  inertial  coordinates,  and  a star  magnitude).  Thus,  420,000  bytes 
of  storage  will  be  needed.  Clearly,  the  entire  catalog  cannot  be  stored  in  core, 
and  some  kind  of  "presorting"  is  necessary.  One  solution  to  this  problem  is 
to  presort  the  catalog  prior  to  each  program  run,  retaining  only  those  stars  in 
the  region  of  the  sky  which  will  be  scanned  by  a camera  during  one  spacecraft 
rotation.  This  procedure  assumes  that  the  spacecraft  spin  axis  attitude  will 
change  by  only  a small  amount  during  the  period  of  interest. 

For  a camera  located  along  the  spin  axis  (or  for  a pointed  satellite),  this  band 
degenerates  into  a circular  cap.  This  technique  works  well  for  a cap,  since 
the  portion  of  the  sky  which  must  be  considered  is  small.  However,  for  a cam- 
era located  with  its  optical  axis  perpendicular  to  the  spin  axis , the  presorting 
technique  just  described  has  some  disadvantages. 

The  major  difficulty  is  that  even  the  reduced  catalog  is  large,  requires  signif- 
icant core  storage,  and  requires  still  further  sorting  inside  the  user's  program. 
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Presorting  the  full  catalog  into  a band  is  very  time  consuming  for  a catalog  the 
size  of  the  SAS-C  and  HEAO-A  catalogs  (21,000  stars).  Furthermore,  this 
method  requires  that  the  entire  input  catalog  be  "resorted’'  if  the  spin  axis  at- 
titude changes  substantially. 

Because  of  this  difficulty,  the  band  technique  was  rejected  in  favor  of  the  sub- 
catalog technique.  A method  is  desired  whereby,  given  any  camera  optical 
axis  pointing,  presorted  subcatalog(s)  can  be  read  into  core  which  will  contain 
data  for  all  stars  visible  to  the  camera.  This  goal  is  achieved  by  dividing  the 
entire  sky  into  zones.  The  zones  overlap  in  declination  to  ease  the  task  of 
determining  which  zones  are  needed  to  cover  the  desired  region  of  the  sky  (see 
Section  6.3.2. 1). 

Once  the  zones  are  defined,  the  catalog  is  sorted  into  subcatalogs,  one  for  each 
zone,  and  stored  on  disk  in  a direct-access  file.  Whenever  a camera  optical 
axis  pointing  is  supplied,  the  requisite  subc.atalog(s)  can  easily  be  identified  by 
searching  a matrix  describing  the  zones,  and  the  needed  stars  read  into  core. 

Programs  which  require  a presorted  band  can  simply  and  efficiently  obtain  the 
band  by  combining  subcatalogs  using  program  LOOKAT,  described  in  Section  8. 

The  subcatalog  technique  satisfies  all  the  requirements  imposed  above.  In  ad- 
dition, it  is  highly  efficient,  because  the  costly  sorting  is  performed  by  pro- 
gram CAT  only  once,  and  not  for  each  run  of  the  user's  program. 

6.  2 PROGRAM  CAT  OVERVIEW 

Program  CAT  sorts  an  input  star  catalog  into  a number  of  overlapping  sub- 
catalogs. The  input  catalog  is  usually  the  Mission  Catalog  and  will  be  referred 
to  as  such  in  this  section,  but  it  could  also  be  the  Master  Catalog  or  a user- 
supplied  catalog. 
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6.  2. 1 Capabilities  of  Program  CAT 

In  order  to  fulfill  the  above  requirements,  program  CAT  performs  the  following 
functions: 

• Divides  the  sky  into  overlapping  zones. 

• Converts  star  geocentric  inertial  unit  vectors  to  right  ascension 
and  declination,  or  vice  versa  (if  needed,  or  if  requested  by  the 
user). 

• Rejects  stars  if  they  are  dimmer  than  a user- specified  limiting 
magnitude  (optional). 

• Sorts  Mission  Catalog  star  data  into  the  zones  if  in  the  catalog 
generation  mode.  Star  data  consists  of  one  4-byte  integer  and  up 
to  seven  4-byte  floating  point  words. 

• Outputs  the  Run  Catalog  in  either  sequential  or  direct-access 
format. 

• Writes  control  records  on  the  output  file  giving  programs 
accessing  the  Run  Catalog  all  the  information  needed  to  read 
the  data  records. 

• Counts  how  many  stars  would  fall  into  each  zone,  if  in  the  star 
counting  mode. 

• Provides  the  user  the  opportunity  to  modify  the  input  data  before 
sorting. 

• Prints  the  output  subcatalogs  (optional). 

6.  2.  2 Program  CAT  Logical  Flow 

Figure  6-1  is  a flowchart  for  program  CAT.  CAT  begins  with  the  input  of  the 
NAMELIST  data  which  defines  the  system  flow.  This  is  performed  by  sub- 
routine CONTRL,  which  reads  the  NAMELIST  and  checks  the  input  values  to 
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Figure  6-1.  Program  CAT  Logical  Flow  (2  of  6) 
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Figure  6-1.  Program  CAT  Logical  Flow  (3  of  6) 
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Figure  6-1.  Program  CAT  Logical  Flow  (4  of  6) 
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Figure  6-1.  Program  CAT  Logical  Flow  (5  of  6) 
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Figure  6-1.  Program  CAT  Logical  Flow  (6  of  6) 
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be  sure  they  lie  within  prescribed  limits.  If  they  do  not,  an  error  message  is 
written,  and  the  job  terminates. 

The  Mission  Catalog  provides  the  input  data  for  program  CAT.  Right  ascen- 
sion and  declination  are  always  required  by  CAT  to  assign  stars  to  appropriate 
zones.  Geocentric  inertial  unit  vectors  are  needed  as  output  in  catalog  gener- 
ation mode.  However,  only  one  or  the  other  might  be  present  in  the  Mission 
Catalog.  If  the  user  indicates  that  only  geocentric  inertial  (G.I.)  unit  vectors 
are  present,  CAT  converts  them  to  right  ascension  and  declination  in  subroutine 
MODIFY.  If  only  right  ascension  and  declination  are  present,  and  if  CAT  is  in 
catalog  generation  mode  (or  if  the  user  requests  it),  G.  I.  unit  vectors  are  cal- 
culated in  MODIFY. 

6.  2.  2. 1 Zone  Definition 

CAT  divides  the  sky  into  overlapping  zones  of  user- specified  size.  The  input 
zone  size  defines  the  declination  range  (height)  of  the  zones.  The  zone  height 
is  increased,  if  necessary,  to  ensure  that  the  resultant  zones  are  symmetric 
about  the  equator. 

CAT  performs  zone  definition  by  calculating  zone  right  ascension  and  declina- 
tion limits.  The  first  zone  defined  is  a circumpolar  zone  about  the  North 
Celestial  Pole. 

As  will  be  explained  in  Section  6.  3.  2. 1,  the  zones  overlap  in  declination  by 
50  percent.  Consequently,  the  next  "row"  of  zones  overlaps  the  north  circum- 
polar zone  such  that  if,  for  example,  the  zone  height  is  30  degrees,  the  row  of 
zones  directly  below  the  north  circumpolar  zone  has  declination  limits  of  -r  45 
and  + 75  degrees.  Figure  6-2  depicts  sample  zone  overlap. 

The  zones  within  a row  are  assigned  a right  ascension  range  (width)  such  that: 

• Each  zone  is  always  at  least  half  as  wide,  in  arc-length,  as  it  is 
high. 


6-12 


ORIGINAL  P £35  '3 
Of  POOR  QUALITY 


Figure  6-2.  Example  of  50  Percent  Zone  Overlap 
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• The  first  zone  in  a row  starts  at  0 degrees  right  ascension  and  the 
last  one  ends  exactly  at  360  degrees  right  ascension. 

Because  of  the  50  percent  zone  overlap  in  declination,  every  star  except  those 
near  the  poles  appears  in  two  zones.  This  increases  the  size  of  the  Run  Catalog 
nearly  two-fold  from  what  it  would  be  without  such  redundancy. 

Elimination  of  "declination  redundancy"  has  not  been  done,  however,  because 
to  do  so  would  greatly  complicate  the  problem  of  determining  the  zones  needed 
to  cover  a specified  region  of  the  sky.  This  is  because  the  right  ascension 
boundaries  of  two  zones  adjacent  in  declination  are  not  necessarily  in  line  with 
each  other. 

After  each  zone  in  a row  is  defined,  CAT  proceeds  to  the  next  row.  Finally,  a 
south  circumpolar  zone  is  defined. 

6.  2.  2.  2 Star  Counting  Mode 

CAT  has  both  a catalog  generation  mode  (see  Section  6.  2.  2.  3)  and  a star  count- 
ing mode.  In  star  counting  mode,  each  star  is  read  from  the  Mission  Catalog 
and  its  magnitude  is  checked  against  the  user-defined  magnitude  limit.  If  the 
star  is  too  dim,  it  is  rejected  and  CAT  reads  the  data  for  the  next  star.  If  it 
is  sufficiently  bright,  the  zones  that  would  contain  the  star  are  determined  and 
their  zone  counters  incremented.  Normally,  a star  falls  in  two  zones,  one  in 
each  of  two  partially  overlapping  declination  rows . The  exceptions  are  stars 
near  the  celestial  poles,  which  occur  only  in  a circumpolar  zone. 

When  all  stars  have  been  processed,  the  results  are  printed. 

6.  2.  2.  3 Catalog  Generation  Mode 

In  catalog  generation  mode,  CAT  begins  by  writing  a control/header  record  on 
the  output  file.  This  record  contains  the  following: 

o The  number  of  zones 

© The  number  of  rows 
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• The  number  of  words  of  data  per  star 

• For  each  row,  five  variables  defining  the  row:  maximum  and 
minimum  row  declination,  right  ascension  width  of  the  zones 
within  the  row,  number  of  the  first  zone  in  the  row,  and  number 
of  zones  in  the  row 

• The  NAMELIST  parameters  used  to  create  the  catalog,  including 
a user-input  80-character  title 

® The  time  and  date  of  catalog  generation 

If  the  output  file  is  to  be  sequential,  seven  dummy  records  are  written;  this 
maintains  similarity  between  direct-access  and  sequential  file  formats. 

Next,  CAT  sorts  the  Mission  Catalog  stars  into  zones.  Fifty  zones  are  proc- 
essed at  one  time.  The  Mission  Catalog  is  read  and  stars  dimmer  than  the 
user-defined  limit  are  rejected.  The  data  for  each  remaining  star  are  stored  in 
the  appropriate  core  arrays  for  the  zone.  When  the  core  array  for  a zone  is 
filled,  it  is  output  onto  temporary  direct-access  disk  storage  (file  30).  A direc- 
tory array  is  loaded  with  the  zone  number  such  that  the  ith  record  on  the  tem- 
porary disk  file  corresponds  to  the  zone  number  for  which  data  are  stored  in  the 
ith  position  in  the  directory. 

When  an  end  of  file  is  encountered  on  the  input  file,  the  temporary  disk  file  di- 
rectory is  interrogated  for  each  zone  number  in  turn.  Appropriate  records 
are  transferred  to  the  permanent  output  file,  and  any  data  remaining  in  core 
are  also  transferred.  A pointer  array  is  loaded  such  that  the  ith  value  of  the 
pointer  array  is  the  logical  record  number  of  the  first  Run  Catalog  record  for 
the  ith  subcatalog.  CAT  then  rewinds  the  Mission  Catalog  and  processes  the 
next  fifty  zones. 

When  all  zones  have  been  processed,  CAT  loads  the  pointer  array  into  records 
two  through  eight  of  a direct-access  file,  or  into  the  last  seven  records  of  a 
sequential  file. 
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CAT  concludes  by  printing  the  subcatalogs  (if  requested  by  the  user)  and  by 
printing  a summary  of  the  zones.  The  summary  includes  right  ascension  and 
declination  of  the  zone  center,  right  ascension  and  declination  of  the  zone 
limits,  the  number  of  stars  in  the  zone,  and  the  number  of  the  first  logical  rec- 
ord in  the  Run  C atalog  for  the  zone . 

Since  the  subcatalog  printout  is  achieved  by  rewinding  the  output  Run  Catalog 
which  CAT  has  just  written  and  then  reading  it  back  into  core  as  needed,  this 
option  checks  the  readability  of  the  output  catalog. 

6.  3 MATHEMATICAL  SPECIFICATIONS 

6.  3. 1 Conversion  Between  Right  Ascension,  Declination  and  Geocentric 
Inertial  Unit  Vector 

Subroutine  MODIFY  may  be  called  to  convert  right  ascension  and  declination 
to  a G.  I.  vector,  or  vice  versa,  using  the  following  equations: 

(6-1) 


(6-2) 

where  a = right  ascension 

6 = declination 

(X»Y,  Z)  = unit  vector  in  G.  I.  coordinates 


or 


a = tan"1  (Y/X) 
6 = sin  1 (Z) 


X = cos  ol  cos  6 
Y = sin  a cos  6 
Z = sin  6 
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Once  the  preliminary  zone  width,  Aa*  , is  calculated,  it  is  increased  such 
that  the  final  zone  width,  da,  is  an  integer  which  evenly  divides  720.  This 
procedure  assures  regular  zones,  with  one  beginning  and  another  ending  at 
0 degrees. 

6.  3.  2.  2 Calculating  the  Zone  Number  and  Zone  Definition  Parameters 

Zone  numbering  is  important  because  the  routines  that  read  the  Run  Catalog 
select  a subcatalog  by  specifying  its  zone  number’.  The  zone  number  is  derived, 
when  accessing  the  Run  Catalog,  from  a camera  optical  axis  pointing  and  zone 
description  arrays.  Zone  1 is  the  north  circumpolar  zone,  which  has  a min- 
imum declination  of  90-W  degrees.  Subsequent  declination  rows  are  defined  by 
maximum  and  minimum  declinations.  The  row  immediately  to  the  south  of  the 
north  circumpolar  zone  extends  from  a declination  of  90-W/2  degrees  to  a dec- 
lination of  90-3W/2  degrees. 

Within  a declination  row,  the  first  zone  begins  at  0 degrees  right  ascension  and 
ends  at  A a degrees;  the  second  begins  at  A a ’and  ends  at  2Aa  , and  so  on. 
Zones  are  numbered  consecutively  in  order  of  increasing  right  ascension.  The 
last  zone  in  a row  ends  at  360  degrees. 

The  final  zone  is  a south  circumpolar  zone,  analogous  to  zone  1,  with  maximum 
declination  of  -90+W  degrees. 

6.  3.  3 Sorting  Stars  into  Zones 

Most  stars  in  the  mission  catalog  fall  into  one  zone  in  each  of  two  overlapping 
declination  rows.  The  exceptions  are  stars  within  W/2  degrees  of  a celestial 
pole  which  fall  only  in  a circumpolar  zone. 

A star  falls  within  a row  provided  that 

6 <6^6 

min  max  (G-o'i 


where  5 is  the  star  declination. 

Pages  6-17  and  6-18  are  blank. 

p»eceowq  pase  a - r 
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It  is  in  a specific  zone  within  that  row  if 


a . < a ^ a 

nun  max 


(6-6) 


where  a is  the  star  right  ascension. 

The  lack  of  the  equal  sign  attached  to  the  first  "less  than"  sign  in  Equation  (6-6) 
prevents  a single  star  from  being  in  both  of  two  adjacent  zones  within  a row. 

6.  4 BASELINE  DIAGRAM  AND  UNIT  DESCRIPTIONS 

6.  4. 1 Baseline  Diagram 

Figure  6-3  is  a baseline  diagram  for  Program  CAT. 

6.  4.  2 Unit  Descriptions 

A unit  description  of  program  CAT  and  each  subroutine  is  presented  in  Sec- 
tions 6.  4.  2. 1 through  6.  4.  2.  6.  An  explanation  of  the  tabular  format's  used 
in  these  subsections  is  given  in  Section  2.4. 1.  Appendix  D is  a FORTRAN 
compiler  listing  of  CAT. 

The  following  is  an  index  to  all  program  CAT  modules. 


Module 

Reference 

CAT 

6-22 

CONTRL 

6-23 

LCHECK 

6-26 

MODIFY 

6-28 

RE  ADI 

6-32 

READ2 

6-34 

6-20 
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Figure  6-3.  Program  CAT  Baseline  Diagram 
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6.4.  2.1  Program  CAT 

DESCRIPTION:  CAT  converts  an  input  star  catalog  into  the  Run  Catalog  format. 
The  user  has  the  option  of  selecting  and  modifying  the  input  data  in  subroutine 
READ1.  The  output  catalog  contains  star  number,  G.I.  unit  vector,  and  user- 
specified  data  for  each  star. 

CALLING  SEQUENCE:  None  (CAT  is  the  main  program) 

COMMON  AREAS  REFERENCED:  CATCOM 

EXTERNAL  REFERENCES:  CONTRL,  MODIFY,  READ1,  READ2 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
printed  output;  30  is  temporary  internal  direct-access  storage;  50  is  temporary 
sequential  storage;  80  is  the  output  catalog  file  (sequential  output  only);  and 
90  is  the  output  catalog  file  (direct-access  output  only).  16  is  defaulted  to 
6 in  CAT. 

ERROR  MESSAGES: 

’EXECUTION  TERMINATING  DUE  TO  OVERFLOW  IN  FILE  30'— Temporary 
storage  file  30  is  too  small.  Enlarge  it  by  altering  the  DEFINE  FILE  30  state- 
ment, the  DATA  statement  containing  the  variable  NLRECS  and  the  DIMENSION 
statement  for  the  IWHO  array.  See  Section  6. 6. 1. 3. 3 and  the  listing  of  CAT  in 
Appendix  D. 

'ZONE  xxx  HAD  yyyyyy  STARS  IN  IT.  THE  MAXIMUM  DESIRED  ACCORDING 
TO  YOUR  NAMELIST  PARAMETER  (NMAX)  IS  zzzzz' — This  is  a warning  only. 
CAT  takes  no  action,  and  the  subcatalog  contains  all  relevant  stars  found  in 
the  Mission  Catalog. 

'ERROR — NSTARS  EXCEEDS  xxx' — This  message  is  found  in  the  zone  summary 
and  occurs  when  the  number  of  stars  in  a single  subcatalog  exceeds  the  maxi- 
mum number  desired  according  to  the  NAMELIST  parameter  NMAX.  CAT 
takes  no  action,  and  the  subcatalog  contains  all  relevant  stars  found  in  the 
Mission  Catalog. 


6-22 


\ * { ! 


ORIGINAL  PAGS  IS 

OF  POOR  QUALITY  CONTRL 


6.  4.  2.  2 Subroutine  CONTRL 

DESCRIPTION:  CONTRL  reads  the  control  parameter  NAMELIST,  &CATIN, 
checks  values  against  the  permissible  range  of  values,  and  outputs  error  mes- 
sages as  needed. 

CALLING  SEQUENCE:  Subroutine  CONTRL  (no  calling  sequence) 

COMMON  AREAS  REFERENCED:  CATCOM 
EXTERNAL  REFERENCES:  LCHECK 
CALLED  BY:  CAT 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  15  is 
NAMELIST  input;  16  is  printed  output.  15  is  defaulted  to  5 and  16  to  6 in 
CONTRL. 

ERROR  MESSAGES: 

'WARNING  ONLY— MAGNITUDE  LIMIT  xxxx.xxx  MAY  BE  TOO  BRIGHT. ' 

A warning  is  printed  when  the  magnitude  limit  is  less  than  3.0.  CAT  takes  no 
abnormal  action. 

'FATAL  ERROR— INPUT  FILE  SPECIFIED  IS  A PROGRAM  CAT  FILE. ' CAT 
terminates  execution.  Files  15,  16,  30,  50,  80,  and  90  are  system  files  not 
available  for  input  (see  NAMELIST  parameter  IFILE). 

'NO  MODIFICATION  SPECIFIED  BUT  ICNVRT  NOT  =7.  CAT  WILL  EXECUTE 
MODIFY  TO  CALCULATE  ALPHA-DELTA  OR  XYZ,  WHICHEVER  IS  NOT 
PRESENT  ON  THE  INPUT  FILE. ' Right  ascension  and  declination  are  not 
available  on  the  input  catalog,  or,  if  the  program  is  in  catalog  generation  mode, 
G.I.  coordinates  are  not  present  on  the  input  catalog.  MODIFY  is  called  to 
calculate  the  required  parameters. 


INPUT/OUTPUT  VARIABLES  FOR  SUBROUTINE  CONTRL 
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6.  4.  2. 3 Subroutine  LCHECK 

DESCRIPTION:  LCHECK  tests  the  values  of  the  NAMELIST  parameters  to 
ensure  that  they  fall  within  the  allowed  range. 

CALLING  SEQUENCE:  Subroutine  LCHECK  (WORD,  FVAL,  IVAL,  LA,  IB, 

FA,  FB,  ITY) 

COMMON  AREAS  REFERENCED:  None 
EXTERNAL  REFERENCES:  None 
CALLED  BY:  CONTRL 

INPUT/OUTPUT  DATA  SETS:  File  16  is  printed  output.  16  is  defaulted  to 
6 in  LCHECK. 

ERROR  MESSAGES: 

'NAMELIST  ERROR -VALUE  OUT  OF  ALLOWED  RANGE.  NAME  = xx  (AL- 
LOWED) yy  - zz. ',  where  NAME  is  the  variable  name,  xx  is  the  NAMELIST 
value  for  the  variable,  and  yy  and  zz  are  the  minimum  and  maximum  values 
permitted.  The  NAMELIST  parameter  was  not  within  the  permitted  range. 
This  is  a fatal  error. 
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6.  4.  2.  4 Subroutine  MODIFY 

DESCRIPTION:  MODIFY  calculates  the  G.  I.  unit  vector,  given  right  ascension 
and  declination,  or  vice  versa. 

CALLING  SEQUENCE:  Subroutine  MODIFY  (no  calling  sequence) 

COMMON  AREAS  REFERENCED:  CATCOM 
EXTERNAL  REFERENCES:  READ1 
CALLED  BY:  CAT 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  50  is 
temporary  sequential  output  of  the  modified  input  catalog.  FORTRAN  data  set 
reference  number  16  is  printed  output.  16  is  defaulted  to  6 in  MODIFY. 
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Table  6-2.  Star  Data  Storage  Variables 


VARIABLE 

MEANING 

OUTPUT 
WORD  NUMBER 
RELATIVE  TO 
START  OF  STAR 
DATA  SEGMENT 

1 STD AT 

STAR  NUMBER 

1 

FSTDAT(I) 

RIGHT  ASCENSION 

NOT  OUTPUT 

FSTDATI2) 

DECLINATION 

NOT  OUTPUT 

FSTDATI3)  ) 

2 

FSTDATI4) 

COMPONENTS  OF  G.l.  UNIT  VECTOR 

3 

FSTDATI5)  ) 

4 

FSTDATI6) 

USUALLY  STAR  MAGNITUDE 

5 

FSTDAT(7) 

OPTIONAL  DATA 

6 

FSTDATI8) 

OPTIONAL  DATA 

7 

FSTDATI9) 

1 

OPTIONAL  DATA 

8 

6-31 


ORIGINAL  PAGS  ?3 
Of  POOR  QUALITY 


READ1 


6.  4.  2.  5 Subroutine  READl 

DESCRIPTION:  READl  is  a user-written  subroutine  which  reads  the  input  star 
catalog.  The  user  may  insert  code  to  modify  input  star  catalog  variables.  A 
listing  of  the  existing  READl  subroutine  is  contained  in  Appendix  D. 

CALLING  SEQUENCE:  Subroutine  READl  (no  calling  sequence) 

COMMON  AREAS  REFERENCED:  CATCOM 

EXTERNAL  REFERENCES:  None 

CALLED  BY:  CAT,  CONTRL 

INPUT/ OUTPUT  DATA  SETS:  The  user-defined  file,  IFILE,  in  COMMON/ 
CATCOM/,  is  used  for  catalog  input. 
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6.  4.  2.  6 Subroutine  READ2 

DESCRIPTION:  READ2  reads  the  star  catalog  which  has  been  modified  by  sub- 
routine MODIFY. 

CALLING  SEQUENCE:  Subroutine  READ2  (no  calling  sequence) 

COMMON  AREAS  REFERENCED:  CATCOM 
EXTERNAL  REFERENCES:  None 
CALLED  BY:  CAT 

INPUT/OUTPUT  DATA  SETS:  File  50  (disk)  is  used  as  input. 
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6.  5 COMMON  AREA  DESCRIPTION  (CATCOM) 

NAME:  CATCOM 

DESCRIPTION:  CATCOM  contains  the  input/output  control  words  needed  by 
program  CAT  and  its  subroutines. 

FORM:  COMMON/ CATCOM/IMODE,  ICNVRT,  IFILE,  W..ISEQ,  FMAG, 

IF  CAT,  NMAX,  NWORDS,  IFMDFY,  TITLE(20),  ISTDAT,  FSTDAT(9),  IEOF 

REFERENCED  BY:  CAT,  CONTRL,  MODIFY,  RE  ADI , READ2 

DEFINITION  OF  VARIABLES: 


Name  Type  Description 

IMODE  1*4  Program  mode  flag: 

= 0,  CAT  produces  Run  Catalog 
= 1,  CAT  only  counts  stars  that  would  be 
put  into  the  zones 

ICNVRT  1*4  Coordinate  conversion  flag: 

= 1,  (a  , 6)  input  and  output 
= 2,  (a  , 6)  input;  G.I.  coordinates 
output 

= 3,  (a  , 6)  input;  both  output 
= 4,  G.I.  coordinates  input; 

(a.  , 6)  output 

= 5,  G.I.  coordinates  input  and  output 
= 6,  G.  I.  coordinate  input;  both  output 
= 7,  both  input  and  output 

IFILE  1*4  Input  catalog  file  number 

W R*4  Desired  declination  width  of  the  zones  in 

degrees;  converted  in  MAIN  to  the  actual 
declination  width 

ISEQ  1*4  Output  file  organization: 

= 0,  direct  access  file 
= 1,  sequential  file 

FMAG  R*4  Limiting  magnitude  for  the  catalog 
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Name  Type 


Description 


IFCAT  1*4 

NMAX  1*4 

NWORDS  1*4 

IFMDFY  1*4 

TITLE(20)  R*4 

ISTDAT  1*4 

FSTDAT(9)  R*4 


IE  OF 


1*4 


Printout  flag: 

= 0,  print  summary  only 
= 1,  print  catalog 

Maximum  number  of  stars  desired  in  a 
sub  catalog 

Number  of  output  words  per  star 

Subroutine  MODIFY  call  flag: 

= 0,  do  not  call  MODIFY 
= I,  call  MODIFY 

Alphameric  title,  80  characters  long 

First  data  word  of  star  data  from  input 
catalog 

Remaining  nine  data  words  of  star  data 
from  input  catalog  or  subroutine  MODIFY. 
Note  that  FSTDAT  is  used  both  as  an  in- 
ternal and  an  output  variable;  only  the 
last  seven  words  of  FSTDAT  are  output 
(see  Table  6-2) 

End-of-file  flag  for  Mission  Catalog. 

When  subroutines  READ1  and  READ2 
return  to  MAIN: 

= 0,  no  EOF  encountered  on  Mission 
Catalog  file 
= 1,  EOF  encountered 
When  subroutines  READ1  and  READ2 
are  called  from  MAIN: 

= 1,  rewind  unit  and  return  data  for  a 
star 

= -1,  return  data  for  a star 
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6.6  USER'S  MANUAL 

This  subsection  will  enable  the  user  to  create  the  proper  NAMELIST  input, 
modify  selected  code  to  handle  special  cases,  interpret  the  output  resulting 
from  program  CAT,  and  formulate  the  appropriate  Job  Control  Language  (JCL). 

6.  6. 1 Input  to  Program  CAT 

Input  to  CAT  consists  of  a NAMELIST,  an  input  star  catalog,  and  a user- 
written  or  modified  subroutine,  READ1. 
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6.  6. 1. 1 NAMELIST  & CATIN 

The  user  may  code  input  data  into  program  CAT  via  NAMELIST  &CATIN.  The 
NAMELIST  parameters,  together  with  their  default  values,  are  presented  in 
the  following  list,  which  adheres  to  the  format  stated  in  Section  2.4.3.  Mul- 
tiple NAMELISTs  cannot  be  used  in  program  CAT. 


Name 

Type 

Default 

IMODE 

1*4 

0 

ICNVA 

1*4 

1 

ICNVB 

1*4 

2 

IFILE 

1*4 

52 

\V 

R*4 

30.0 

ISEQ 

1*4 

1 

FMAG 

R*4 

9.99 

Description 

Program  mode  flag: 

= 0,  CAT  produces  Run  Catalog 
= 1,  CAT  only  counts  stars  that 
would  be  put  into  the  zones 

Star  coordinate  input  control  flag: 

= 1,  right  ascension  and  declina- 
tion input 

= 2,  G.  I.  unit  vector  input 
= 3,  both  input 

Star  coordinate  output  control  flag: 
= 1,  right  ascension  and  declina- 
tion output 

= 2,  G.  I.  coordinates  output 
= 3,  both  output 

Input  catalog  file  number.  Valid 
range:  1 £ IFILE  £ 99,  but  not 
30,  50,  80,  90  or  15,  16  (defaul- 
ted to  5 and  6,  respectively) 

Desired  declination  width  of  the 
zones  (degrees).  Valid  values 
are  shown  in  Table  6-1 

Output  file  format  flag: 

= 1,  sequential  file 
= 2,  direct-access  file 

Limiting  magnitude  for  the  cata- 
log. Restrictions  explained  in 
Section  6.  6. 1. 3. 1. 
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Name 

Type 

Default 

Description 

IFCAT 

1*4 

0 

Printout  flag: 

= 0,  summary  printout  only 
= 1,  full  catalog  printout 

NMAX 

1*4 

9999 

Maximum  number  of  stars  de- 
sired in  a subcatalog 

N WORDS 

1*4 

8 

Number  of  output  words  per  star. 
Valid  range:  4 £ NWORDS  ^ 8 

IFMDFY 

1*4 

0 

Subroutine  MODIFY  call  flag: 
= 0,  do  not  call  MODIFY 
= 1,  call  MODIFY 

TITLE  (20) 

R*4 

20*'bbbb' 

User  input  title  (80  characters) 

6.  6. 1.  2 Input  Star  Catalog 

The  input  catalog  must  contain  star  numbers  and  positions.  Usually,  it  will 
also  contain  an  instrumental  magnitude,  or  an  approximation  to  one,  such  as 
the  stellar  magnitude  in  a standard  system. 

The  input  star  catalog  must  reside  on  the  file  designated  by  the  NAMELIST 
parameter  IFILE.  IFILE  may  be  any  number  from  1 through  99  except  30,  50, 
80,  90,  or  15,  16  (defaulted  to  5 and  6 respectively).  The  SKYMAP  Mission 
Catalog  is  usually  the  input  catalog  to  program  CAT.  If  a Mission  Catalog  is 
not  created,  the  Master  Catalog  can  be  used,  as  can  any  other  catalog  supplied 
by  the  user  which  contains  the  necessary  data.  Subroutine  READ1,  which  is 
user  supplied,  reads  the  input  catalog.  The  output  required  by  CAT  from 
READ1  is  discussed  below. 

6.  6. 1.  3 Source  Code  User  Modifications 

The  user  may  need  to  alter  subroutine  READ1  and  the  MAIN  routine. 
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6.  6. 1.3.1  Subroutine  READ1 


The  user  must  supply  subroutine  READ1  to  read  the  input  star  catalog.  A de- 
fault version  of  READl  has  been  provided  which  reads  the  Master  Catalog  and 
outputs  star  number  (HD  number),  geocentric  inertial  unit  vector  components 
and  instrumental  magnitude.  A listing  of  the  current  READl  subroutine  is 
shown  in  Appendix  D along  with  the  listing  of  program  CAT. 

READl  communicates  with  CAT  via  COMMON/CATCOM/.  The  star  data  which 
READl  must  place  in  CATCOM  are  as  follows : 


1ST  DAT 
FSTDAT(l) 
FSTDAT(2) 
FSTDAT(3) 
• F ST  DAT  (4) 
FSTDAT(5) 
FSTDAT(6) 
FSTDAT(7) 
FSTDAT(8) 
FSTDAT(9) 
IEOF 


Integer  output  word,  usually  the  star  number 
Right  ascension  (if  given) 

Declination  (if  given) 

X-coordinate  in  G.I.  coordinates  (if  given) 

Y-coordinate  in  G.I.  coordinates  (if  given) 

Z-coordinate  in  G.I.  coordinates  (if  given) 

Star  magnitude  (optional) 

Extra  floating  point  output  word  (optional) 

Extra  floating  point  output  word  (optional) 

Extra  floating  point  output  word  (optional) 

= 0,  if  no  end  of  file  was  encountered  on  the  input  file 
= 1,  if  an  end  of  file  was  encountered  on  the  input  file 


If  IEOF  = -1  when  READl  is  called,  the  unit  should  be  rewound  (if  applicable). 
FSTDAT(6)  should  be  set  to  0.  0 if  star  magnitudes  are  not  going  to  be  output 
because  FSTDAT(6)  is  always  checked  in  CAT  agains  the  NAMELIST  parameter 
FMAG  to  determine  if  the  star  is  bright  enough  to  be  included  in  the  catalog. 

If  information  other  than  magnitude  is  stored  in  FSTDAT(6),  ensure  that  FMAG 
is  large  enough  to  avoid  rejection  of  data. 
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6.  6. 1. 3.  2 The  MAIN  Routine 

It  is  envisioned  that  the  only  changes  the  user  will  want  to  make  to  MAIN  are  to 
alter  the  size  of  the  direct-access  data  sets  (files  30  and  90)  referenced  by 
CAT.  File  30  is  always  required,  and  file  90  is  needed  when  CAT  is  to  pro- 
duce a direct-access  run  catalog.  If  the  size  of  these  files  is  too  small,  a user 
SD37  ABEND  will  occur.  If  they  are  too  large,  excess  disk  storage  and  I/O 
time  will  be  used. 

To  determine  the  proper  sizes  for  files  30  and  90,  CAT  should  be  run  in  star 
counting  mode.  The  numbers  of  logical  records  needed  for  each  are  printed 
at  the  end  of  the  output. 

To  alter  the  size  of  file  30,  change  the  statement  at  sequence  number  00008300 
in  the  MAIN  program: 

DEFINE  FILE  30  (2000,  410,  U,  NEXT) 

The  first  parameter  in  parentheses  should  be  set  to  the  number  of  logical  rec- 
ords desired  for  that  file.  The  JCL  DD  statement  for  FT30F001  must  also 
agree  with  this  DEFINE  FILE. 

To  alter  the  size  of  file  90,  change  the  statement  at  sequence  number  00008400 
and  00008401  in  the  MAIN  program: 

DEFINE  FILE  90  (2000,  410,  U,  NEXTFN) 

DATA  NLRECS/ 2000/ 

The  first  parameter  in  parentheses  in  the  DEFINE  FILE  90  statement  should  be 
set  to  the  number  of  logical  records  desired  for  that  file.  The  value  for 
NLRECS  in  the  DATA  statement  should  also  be  set  to  this  value.  The  JCL  DD 
statement  for  FT90F001  must  also  agree  with  this  DEFINE  FILE. 
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6.6.2  Output  From  Program  CAT 
6.  6.  2. 1 Run  Catalog 

CAT  will  create  either  a sequential  or  a direct-access  Run  Catalog.  The  pro- 
gram that  reads  the  Run  Catalog,  LOOKAT,  can  only  use  the  direct-access 
version.  However,  the  user  may  wish  to  store  the  Run  Catalog  on  tape  and  only 
unload  it  onto  disk  when  it  is  needed.  In  that  case,  CAT  should  be  used  to 
create  a sequential  Run  Catalog  on  tape,  and  program  SWITCH  should  be  used 
to  load  it  onto  disk  in  direct-access  format  (see  Section  7). 

6.  6.  2. 1. 1 Run  Catalog  Organization 

The  organization  of  the  sequential  and  direct-access  versions  of  the  Run  Cat- 
alog, shown  in  Figure  6-4,  are  identical  up  through  the  last  data  record,  NT, 
of  the  last  subcatalog,  N.  The  direct-access  version  of  the  Run  Catalog  is 
written  on  FORTRAN  data  set  reference  number  90  using  an  unformatted 
FORTRAN  write  statement  and  a DEFINE  FILE  statement.  The  record  length 
is  1640  bytes  (410  4-byte  words  per  record).  The  sequential  version  has  a 
fixed  block  format,  a logical  record  length  of  1640  bytes,  and  a block  size  of 
6560  bytes. 

6. 6. 2. 1.2  Catalog  Structure 

The  first  eight  (logical)  records  of  the  direct-access  Run  Catalog  and  the  first 
one  and  last  seven  records  of  the  sequential  Run  Catalog  contain  data  needed  by 
the  access  module  of  program  LOOKAT,  which  reads  the  catalog. 

The  second  through  eighth  records  of  the  direct-access  version  and  the  last 
seven  records  of  the  sequential  version  contain  pointers  corresponding  to  the 
first  logical  record  of  data  pertaining  to  each  of  the  subcatalogs.  Some  of  the 
data  needed  for  these  records  is  not  available  until  the  sorting  is  complete, 
which  creates  a problem  if  output  is  sequential.  To  keep  the  direct-access  and 
sequential  versions  as  similar  as  possible,  records  two  through  eight  in  the 
sequential  file  are  filled  with  dummy  data.  At  the  end  of  the  catalog  generation, 
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I NT+5  i 

1 -| 

| NT+6  | 

| 1 

| NT*7  | 

i J J 


DESCRIPTION 


CONTROL/HEADER  RECORD 


SUBCATALOG  POINTER  RECORDS  (THESE  SEVEN  RECORDS  ARE 
ONLY  MEANINGFUL  FOR  DIRECT-ACCESS  DATA  SET  RUN 
CATALOGS) 


RECORD  GROUP  FOR  1ST  SU8CATALOG  (ONE  OR  MORE  RECORDS) 


RECORO  GROUP  FOR  NTH  SUB-CATALOG  (ONE  OR  MORE  RECORDS) 


SUBCATALOG  POINTER  RECORDS  (THESE  SEVEN  RECORDS  ARE 
ONLY  PRESENT  FOR  SEQUENTIAL  DATA  SET  RUN  CATALOGS) 


‘LENGTH  OF  ALL  RECORDS  IS  1640  BYTES  = 410  4-BYTE  WORDS 


Figure  6-4.  Run  Catalog  Structure 
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the  data  contained  in  the  second  through  eighth  records  of  the  direct-access 
version  are  written  as  the  last  seven  records  in  the  sequential  version.  The 
final  seven  records  of  the  sequential  catalog  can  be  easily  recognized,  as  they 
contain  the  integer  constant  987654  as  the  401st  through  410th  word. 

For  either  version,  the  star  data  subcatalogs  start  at  the  ninth  logical  record 
as  shown  in  Figure  6-4.  Subsection  6.6.  2. 1.4  details  the  format  of  the  sub- 
catalogs . 

6.  6.  2. 1.3  Format  of  the  Control/Header  Record  and  Pointer  Records 

The  first  record  of  data  on  the  Run  Catalog  contains  the  sub-catalog  control 
words  and  header  information.  Table  6-3  defines  the  data  found  in  this  record. 

The  second  through  eighth  record  of  the  direct-access  catalog,  and  the  last 
seven  records  of  the  sequential  catalog,  contain  the  1*4  record  pointers.  The 
pointers  are  written  400  to  a record,  plus  10  dummy  words  at  the  end  con- 
taining the  integer  987654.  The  ith  pointer  in  this  group  of  seven  records  is 
the  record  number  corresponding  to  the  first  record  for  the  ith  subcatalog. 
Those  pointers  which  are  not  used  if  there  are  fewer  than  2800  subcatalogs 
are  set  to  0.  0. 

The  control/header  record  and  pointer  records  are  read  automatically  by 
program  LOOKAT  which  provides  the  interface  between  the  Run  Catalog  and 
attitude  determination  programs. 

6.6.  2. 1.4  Subcatalog  Format 

A subcatalog  consists  of  one  or  more  consecutive  410  word  logical  records. 

The  logical  records  are  constructed  of  segments  NWORDS  long,  where 
NWORDS  is  a NAMELIST  parameter  whose  value  must  be  4 s NWORDS  <3. 

The  organization  of  these  records  is  shown  in  Figure  6-5. 

The  first  two  segments  of  the  first  logical  record  for  a subcatalog  contain 
control  words  which  are  described  in  Table  6-4.  Each  following  segment 
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Table  6-3.  Data  Words  in  the  Control/Header 
Record  of  the  Run  Catalog 


WORD  POSITION 
IN  RECORD 

FORMAT 

DESCRIPTION 

1 

1*4 

NUMBER  OF  SUBCATALOGS 

2—201 

FOR  EACH  DECLINATION  ROW  OF  ZONES.  UP  TO 
A MAXIMUM  OF  40  ROWS.  FIVE  WORDS  DEFINING 

R *4 

• MAXIMUM  ROW  DECLINATION 

R *4 

• MINIMUM  ROW  DECLINATION 

R *4 

• RIGHT  ASCENSION  WIDTH  OF  THE  ZONES 
IN  THE  ROW 

1*4 

• NUMBER  OF  THE  FIRST  ZONE  IN  THE  ROW 

1*4 

• TOTAL  NUMBER  OF  ZONES  IN  THE  ROW 

THE  FIRST  FIVE  WORDS  REFER  TO  ROW  1,  THE 
NEXT  FIVE  TO  ROW  2.  ETC.  WORDS  WHICH  ARE 
NOT  USED  BECAUSE  THERE  ARE  FEWER  THAN 
40  ROWS  ARE  MEANINGLESS. 

202 

1*4 

NUMBER  OF  ROWS 

203 

1*4 

NUMBER  OF  WORDS  OF  DATA  PER  STAR 

204 

1*4 

COMMON/CATCOM/PARAMETER  ICNVRT 

205 

1*4 

NAMELIST  PARAMETER  IFILE 

206 

R *4 

NAMELIST  PARAMETER  W 

207 

1*4 

i 

NAMELIST  PARAMETER  ISEQ 

208 

R *4 

NAMELIST  PARAMETER  FMAG 

209 

1*4 

NAMELIST  PARAMETER  NMAX 

210 

1*4 

NAMELIST  PARAMETER  IFMDFY 

211-230 

R *4 

NAMELIST  PARAMETER  TITLE 

231-237 

R *4 

TIME  OF  DAY  AND  DATE  WHEN  CAT  WAS  RUN 
TO  GENERATE  THE  RUN  CATALOG 

238-410 

- 

MEANINGLESS 
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SUBCATALOG 
DATA  RECORD 


FIRST  RECORD 
IN  SUBCATALOG 


SEGMENT 

NUMBER 

NUM8ER  OF 
4-BYTE  WORDS 

1 

4 

i i 

NWORDS 

f 

k 

2 

k 

NWORDS 

t 

3 

k 

NWORDS 

f 

ETC 

k 

NWORDS 

f 

• 

1 

k 

NWORDS 

f 

~ ~ 410  WORDS 


• 

i 

y 

k 

NWORDS 

• 

4 

y 

♦ 

NWORDS 

• 

4 

y 

NWORDS 

f 

< NWORDS 

SEGMENT 

DESCRIPTION 


SUBCATALOG  STATISTICS 
(SEE  TABLE  6-4) 


SUBCATALOG  LIMITS 
(SEE  TABLE  6-4) 


STAR  DATA  WORDS* 


STAR  DATA  WORDS* 


STAR  DATA  WORDS* 


STAR  DATA  WORDS* 

STAR  DATA  WOROS* 

STAR  DATA  WORDS* 

LEFT  OVER  BLANK  WORDS  (0  0) 


SUBSEQUENT 
RECORDS 
IN  SUBCATALOG 
(IF  ANY) 


NWORDS 


NWORDS 


NWORDS 


NWORDS 


NWORDS 


410  WORDS 


NWORDS 


NWORDS 


< NWORDS 


STAR  DATA  WORDS 
STAR  DATA  WORDS* 

STAR  DATA  WORDS* 

STAR  DATA  WORDS* 

STAR  DATA  WORDS* 

STAR  DATA  WORDS* 

STAR  DATA  WORDS* 

LEFT  OVER  BLANK  WORDS  (0  0) 


•WORDS  IN  THE  REMAINDER  OF  THE  RECORD  AFTER  THE  LAST  STAR  DATA  ENTRY  IN  THE  SUB-CATALOG 
ARE  SET  TO  0.0 


Figure  6-5.  Run  Catalog  Subcatalog  Data  Record  Organization 
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Table  6-4. 


Contents  of  First  Two  Segments  of  First  Record 
in  a Run  Catalog  Subcatalog 


SEGMENT 

NUMBER 

— 

WORD 
POSITION 
IN  SEGMENT 

— 

FORMAT 

DESCRIPTION 

1 

1 

1*4 

SUBCATALOG  NUMBER 

2 

R *4 

RIGHT  ASCENSION  OF  T.HE  ZONE 
CENTER  (DEGREES) 

3 

R *4 

OECLINATION  OF  THE  ZONE  CENTER 
(DEGREES) 

4 

1*4 

NUM8ER  OF  STARS  IN  THE  SUB- 
CATALOG 

5 

THROUGH 

NWORDS 

IF  THESE  WORDS  ARE  PRESENT 
(1  E.,  4 < NWORDS  < 3),  THEY  ARE 
MEANINGLESS 

2 

1 

MAXIMUM  RIGHT  ASCENSION  OF 
THE  ZONE  (DEGREES) 

2 

MINIMUM  RIGHT  ASCENSION  OF 
THE  ZONE  (DEGREES) 

3 

MAXIMUM  DECLINATION  OF  THE 
ZONE  (DEGREES) 

4 

MINIMUM  DECLINATION  OF  THE 
ZONE  (DEGREES) 

5 

THROUGH 

NWORDS 

IF  THESE  WORDS  ARE  PRESENT 
(I.E.,  4 < NWORDS  ■£  3),  THEY  ARE 
MEANINGLESS 
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contains  data  for  a single  star.  The  words  within  a star  data  segment  are  given 
in  Table  6-5.  Stars  are  ordered  in  the  Run  Catalog  in  the  order  they  appear  in 
the  input  catalog. 

In  program  CAT  segments  of  data  are  first  stored  in  a core  array.  When  a 
total  count  of  (410-NWORDS)  words  is  exceeded  in  the  core  array,  the  complete 
segment  is  stored,  and  the  array  is  written  on  a temporary  output  file.  The 
limit  was  chosen  to  ensure  that  sufficient  space  was  left  in  the  410  word  core 
array  to  finish  storing  the  data  for  the  final  star.  Any  unfilled  words  at  the 
end  of  a partial  record  are  left  blank. 

6.  6.  2.  2 Printed  Output  from  CAT 

CAT  produces  the  following  printed  output  to  assist  in  evaluating  the  program 
performance: 

® A table  of  NAMELIST  parameters,  the  values  assigned  to  them, 
and  a description  of  their  meaning  (Figure  6-6) 

® A series  of  self-explanatory  error  messages  concerning  NAMELIST 
parameter  values.  Some  are  fatal.  If  the  program  printout  ends 
here,  correct  the  indicated  error  and  rerun  the  job.  The  meaning 
of  each  error  message  is  given  in  Table  6-6. 

• If  MODIFY  has  been  called,  a statement  that  MODIFY  is  finished, 
the  number  of  stars  it  output,  and  the  number  of  the  last  star  (Fig- 
ure 6-7) 

• The  parameters  defining  the  rows  (Figure  6-8) 

• The  parameters  defining  the  zones  (Figure  6-9) 

When  exercising  the  star  counting  mode,  the  following  is  printed: 

® A table  of  the  number  of  stars  in  a zone,  including  zone  number, 
maximum  and  minimum  zone  declination,  maximum  and  minimum 
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Table  6-5.  Data  Words  in  a Run  Catalog 
Star  Data  Segment 


RELATIVE 

POSITION 

FORMAT 

DESCRIPTION 

1 

1*4 

USUALLY  THE  STAR  NUMBER 

2-4 

R*4 

THE  STAR'S  GEOCENTRIC  INERTIAL  UNIT  VECTOR 
AT  A SPECIFIED  EPOCH  (X,  Y.  Z) 

5* 

R*4 

SIXTH  FLOATING  POINT  WORD  OUTPUT  BY  READ1 
OR  READ2  THIS  SHOULD  BE  THE  STELLAR  INSTRU- 
MENTAL MAGNITUDE,  IF  PRESENT 

6* 

R*4 

SEVENTH  FLOATING  POINT  WORD  OUTPUT  BY 
READ1  OR  READ2 

7* 

i 

R*4 

| 

EIGHTH  FLOATING  POINT  WORD  OUTPUT  BY 
READ1  OR  READ2 

8* 

R *4 

NINTH  FLOATING  POINT  WORD  OUTPUT  BY  READ1 
OR  READ2 

OPTIONAL  WORDS 


TITLT  — TC'iT  CATALOG  GFNi.H-UfcC  HY  U*  GOT  TL I F 0 ON  AIJi(IL 
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Table  6-6.  Program  CAT  Error  Messages 


FROM  MAIN 

•EXECUTION  TERMINATING  DUE  TO  OVERFLOW  IN  FILE  30'  - TEMPORARY 
DIRECT-ACCESS  STORAGE  FILE  IS  TOO  SMALL.  ENLARGE  IT  BY  ALTERING 
THE  DEFINE  FILE  STATEMENT,  THE  DATA  STATEMENT  CONTAINING  THE 
VARIABLE  NLRECS  AND  THE  DIMENSION  STATEMENT  FOR  THE  IWHO 
ARRAY  IN  THE  MAIN  PROGRAM 

'ZONE  xxxx  HAD  yyyyyy  STARS  IN  IT  THE  MAXIMUM  DESIRED  ACCORDING 
TO  YOUR  NAMELIST  PARAMETER  (NMAXI  IS  zzzzz’  - WARNING  ONLY 
CAT  TAKES  NO  ACTION,  AND  YOUR  FULL  CATALOG  IS  STORED  ON  THE 
OUTPUT  FILE. 

'ERROR  - NSTARS  EXCEEDS  xxx'  - FOUND  IN  THE  ZONE  SUMMARY. 
THIS  MESSAGE  OCCURS  WHEN  THE  NUMBER  OF  STARS  IN  A SINGLE 
SUB-CATALOG  EXCEEDS  THE  MAXIMUM  NUMBER  OESIRED  ACCORDING 
TO  THE  NAMELIST  PARAMETER  NMAX.  CAT  TAKES  NO  ACTION,  AND 
YOUR  FULL SUB*CATALOG  ISON  THE  OUTPUT  FILE. 

FROM  CONTRL: 

'WARNING  ONLY  - MAGNITUDE  LIMIT  xxxx.xxx  MAY  BE  TOO  BRIGHT.' 
WARNING  IS  PRINTED  WHEN  LIMITING  MAGNITUDE  IS  < 3.0,  CAT  TAKES 
NO  ACTION. 

'FATAL  ERROR  - INPUT  FILE  SPECIFIED  IS  A PROGRAM  CAT  FILE.' 

CAT  TERMINATES  EXECUTION.  FILES  15,16,30,50,80  AND  90  ARE  SYSTEM 
FILES  NOT  AVAILABLE  FOR  INPUT  (SEE  NAMELIST  PARAMETER  IFILE). 

'NO  MODIFICATION  SPECIFIED  BUT  ICNVRT  NOT  =7.  CAT  WILL  EXECUTE 
MODIFY  TO  CALCULATE  ALPHA-DELTA  OR  XYZ,  WHICHEVER  IS  NOT 
PRESENT  ON  THE  INPUT  FILE.'  RIGHT  ASCENSION  AND  DECLINATION 
ARE  NOT  AVAILABLE  ON  THE  INPUT  CATALOG,  OR  (DURING  CATALOG 
GENERATION  MODE  ONLY)  GEOCENTRIC  INERTIAL  COORDINATES  ARE 
NOT  PRESENT  ON  THE  INPUT  CATALOG  THEY  ARE  NEEDED,  SO  MODIFY 
IS  CALLED  TO  CALCULATE  THEM 

FROM  LCHECK. 

'NAMELIST  ERROR  - VALUE  OUT  OF  ALLOWED  RANGE.  NAME  *=  xx 
(ALLOWED)  yy  - zz  ' FATAL  ERROR  THE  NAMELIST  PARAMETER  WAS 
NOT  WITHIN  THE  PERMITTED  RANGE. 
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zone  d£f  inition 

number  DECLINATIONS  RIGHT  ASCENSIONS 


• 

MIN. 

MAX. 

MI  N. 

MAX. 

1 

60.000 

90. 000 

C.O 

360. 000 

2 

45*000 

75. 000 

C.  0 

60. 000 

3 

45*00  0 

75.000 

6 C. 000 

120.000 

4 

45*000 

75.000 

12  C. 9C0 

180.000 

c. 

45*  00  0 

75.000 

1 8 C.  0C0 

24  0.  0 00 

£ 

45. 00  0 

75. 000 

24  C. 000 

300. 000 

7 

45.000 

75.000 

30  C. 000 

360.000 

a 

30. COO 

60.000 

C . 0 

30. 000 

9 

30.000 

50.000 

3 C. 000 

60. 000 

l c 

30.000 

60.000 

6.0. 00  0 

90. 000 

i i 

30*000 

60.000 

90.000 

1 2 0.  0 00 

I 2 

3 0.000 

60.  OC  0 

12  C. 000 

150. 000 

1 3 

3 0.000 

60. 000 

15C.00C 

130.000 

1 A 

30.000 

o 0 . 0 0 0 

i a c. ooo 

21 0.000 

1 5 

30.000 

6 0. 00  0 

21 c. coo 

240. 000 

1 6 

30.000 

60.000 

2 4 0 . 0 C 0 

2 70.  000 

l 7 

30  *000 

60. 000 

27  C. 000 

300. 000 

i a 

30 . 00  0 

6 0 • C 0 0 

30  C. 00  0 

330. 000 

l 9 

30 . 00  0 

60. 000 

33  C. 000 

360. 000 

20 

15 .00  0 

45.000 

C . 0 

22 .500 

2 1 

15. COO 

45.000 

22.500 

45.000 

2 2 

15.000 

45.000 

4 5. 00  0 

67.500 

23 

15.000 

45.  000 

6 7.500 

90.  000 

24 

15.000 

45.000 

9 C . 0 0 0 

112. 500 

25 

1 5. 00  0 

45.000 

112.500 

135. 000 

26 

15  *C0  0 

45.000 

135.000 

157.500 

27 

15.000 

45.000 

157.500 

1 80.000 

28 

15. 00  0 

45.000 

130. 0C0 

2 02 . 500 

29 

15.000 

45. 00  0 

202. SCO 

225. COO 

30 

15.000 

45. 000 

225.000 

247.500 

3 1 

15.000 

45.000 

24  7.500 

270. 0 00 

32 

15.00  0 

45.000 

27C. 000 

292.500 

33 

15. COO 

45.000 

292.500 

3 1 5 • C 0 0 

34 

15.000 

45.  00  0 

31 5. OOC 

33  7. 500 

35 

15  .00  0 

4 5.  00  0 

33  7.50  0 

360. 000 

36 

0.0 

30. 000 

C.  0 

18.000 

37 

0 . 0 

30. 0C0 

1 e. 000 

36. 000 

3 8 

0 . 0 

30 . 000 

36.000 

54 . 0 00 

39 

0.0 

30. 000 
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72 • 000 

40 
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30.000 

72.000 

90.  OOC 

4 l 
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ica.ooo 
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4 3 
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126. 000 
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1 44. COO 

l 62. 000 

45 
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180. 00 0 

4 6 
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4 7 
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252 • 000 

50 

0.  c 
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283. 000 

52 
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288. 0C0 

306. 000 

53 
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30. 000 

306. 000 

324.0  CO 

54 
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32  4.  000 

342 . 000 
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i e.ooo 

36. 000 
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6 1 
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66 

- 15.00  0 
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21 6.000 
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Figure  6-9.  Sample  Output  From  CAT,  Zone  Definition 
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zone  right  ascension  and  the  number  of  stars  in  the  zone 
(Figure  6-10) 

• Total  number  of  stars  included  in  one  or  more  zones;  total  number 
of  entries,  and  the  actual  redundancy  factor  (average  number  of 
entries  per  star)  (Figure  6-11) 

When  in  the  catalog  generation  mode,  the  following  is  printed: 

• A summary  of  errors  occurring  during  catalog  sorting,  if  any. 

The  errors  and  actions  that  must  be  taken  to  correct  them  are 
discussed  in  Table  6-6. 

• If  the  job  terminates  properly,  the  statement  "END  OF  CATALOG" 
is  printed. 

When  a full  catalog  printout  has  been  requested  (IFCAT=1),  the  contents  of 
each  sub  catalog  is  printed,  including  the  following: 

• Star  number 

® G.  I.  unit  vector 

• Up  to  four  other  data  words  (Figure  6-12) 

The  last  printed  output  from  CAT  is  a summary  of  the  parameters  describing 
the  zones.  The  summary,  shown  in  Figure  6-13,  includes  the  zone  number, 
the  coordinates  of  the  zone  center,  the  coordinates  of  the  zone  limits,  the  num- 
ber of  stars  in  the  zone,  and  the  output  file  record  number  for  the  first  record 
of  the  subcatalog  corresponding  to  the  zone.  Any  zones  containing  more  stars 
than  indicated  by  NAMELIST  parameter  NMAX  are  flagged.  A final  sentence 
gives  the  maximum  number  of  stars  in  any  one  zone. 

6.  6.  3 Job  Control  Language 

CAT  may  be  run  from  a FORTRAN  source  or  a load  module.  The  JCL  shown 
in  Figure  6-14  assumes  CAT  is  being  run  from  a cataloged  source  data  set 
named  CAT.  FORT,  and  that  the  input  Mission  Catalog  is  on  a cataloged  data 
set  named  ENPUTCAT. DATA. 
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zone  cclms 


Znf'iE 

OECLI  NATIONS 

RIGHT 

ASCENS  ICNS 

NO.  STiRS 

l 

6^.  33 

90.  00 

0.0 

260 .CO 

1080 

2 

45.10 

75.  00 

0.0 

6C  .00 

130 

3 

46. 

75.  on 

60.00 

12C.0O 

180 

4 

45.0  1 

75.  00 

120.00 

1 8C .CO 

130 

5 

46.0  0 

75.  00 

180.00 

240.00 

1 80 

6 

4 5.00 

75.  00 

240.00 

30C.CO 

180 

7 

45.  1 1 

75.  10 

300.00 

J6C .00 

1 90 

9 

3 0.01 

oO*  00 

0.0 

31.00 

90 

3 

20.0) 

60.  30 

30.00 

6 C . 00 

90 

l" 

i o. : i 

60.  JO 

60.00 

90. CO 

9 C 

1 \ 

1 1 . V J 

60.  OO 

90.00 

120.00 

90 

l ^ 

5 1.00 

oO.  50 

120.00 

15C.C0 

90 

i ’ 

i o. : i 

60.  00 

•!  50.00 

iac .cc 

90 

i-> 

36.00 

60. 00 

180.01 

2 1 C . 00 

90 

1 5 

2 C . 0 0 

60.  OO 

210.00 

"243  . CO 

90 

1 O 

3 1 . : ** 

60.  11 

241.00 

2 70. CO 

90 

1 7 

3 0.00 

60.  00 

271.30 

300 .CC 

90 

1 s 

2 ' • 0 0 

60.  10 

300.03 

330.00 

9*3 

1 9 

J ).  0 0 

60.  10 

330.00 

360. CO 

90 

; - 

13.00 

45.  JO 

1.0 

22.50 

90 

2 1 

15.0, 

45.  30 

22.50 

45  . CO 

60 

7 2 

i - . :■  i 

4 5.03 

45.00 

6 7.50 

eo 

->  T 

i : . o o 

4 5.  13 

6 7.50 

5C  . 00 

6 0 

7 A 

1 3.  0 ) 

45.  30 

9-1.30 

112.50 

90 

25 

16.90 

45.  iO 

112.53 

135.00 

6 0 

15.1' 

45.  3 1 

135.00 

157.50 

60 

2 7 

15.0) 

45.  30 

157.50 

18C.CC 

o 0 

23 

15.05 

45.13 

181.00 

2 32 . 5 J 

90 

2 9 

; 5.00 

45.  30 

202.50 

225. CO 

c-J 

-»  - 

1 5.  10 

45.  .0 

22  5 . 3 J 

247.50 

60 

i • 

15.00 

45.  30 

. 247.50 

87G.CQ 

o J 

7 7 

l 5.00 

45.  30 

’270. CC 

292 . SO 

OO 

\ 2 

15.0) 

45.  10 

292.53 

31 5. 10 

60 

14 

16.00 

45.  30 

31 5.00 

337. SO 

60 

35 

1 5.0  0 

45.  30 

337.50 

360.00 

60 

36 

o 

3 0.  00 

0.3 

1 6. CO 

6 C 

37 

0.  1 

30.  30 

18.00 

36. CO 

60 

16 

0.  0 

30.  1) 

36.00 

54.00 

60 

39 

0. 0 

30.  10 

S4.no 

72. CO 

6C 

4.) 

1. 1 

30.  JO 

72.00 

90. CJ 

30 

4 1 

0 . 0 

30.  10 

90.03 

1 18. CO 

6C 

**  2 

0.  6 

30.  00 

i os. oo 

126. CO 

60 

43 

0 . ^ 

30.00 

126. CO 

144  .CO 

60 

44 

0. 0 

30.  JO 

144 .00 

162.00 

oC 

45 

0.  0 

30.  3 1 

162.00 

13C .CO 

30 

4£ 

1.  J 

30.  JO 

181.00 

196.00 

GO 

4 7 

0.  "» 

30.  10 

19H.C0 

21 t .CO 

60 

4 a 

0 • j 

30.  3 J 

21 6. CO 

234. CO 

6 C 

4 

0.  ) 

30.  00 

.234.00 

252. OJ 

h ) 

50 

5.0 

3 0.00 

2 52.00 

270. CO 

JO 

51 

f • sJ 

30.  JO 

270.00 

283.00 

6C 

52 

0.0 

3 J*  30 

283.00 

286. CO 

60 

53 

1.1 

30.  30 

306.00 

224  .CO 

60 

54 

0.0 

30.  JO 

324.00 

342.00 

6C 

55 

0.  u 

3 0.  00 

342.33 

36C  .CO 

30 

56 

-15.00 

15.  30 

0.0 

l 6.C0 

60 

57 

-15.00 

15.  U 

1 5.30 

36  .CO 

63 

5 3 

-15.01 

1 5.  00 

36.00 

54 .00 

60 

59 

-15.00 

15.  10 

54.00 

72.  CO 

60 

60 

-15.00 

15.  OO 

72 .00 

90.  CO 

3C 

61 

-15.00 

l 5.  3 3 

9 0.00 

1 J8 .00 

60 

62 

- 1 5.0  0 

1 5.  30 

109.00 

126 .CO 

oO 

63 

-15.00 

15.  00 

126  . CC 

144.00 

60 

04 

-15.01 

1 5.  10 

144.00 

162. CO 

60 

65 

-15.01 

1 5.  00 

162.00 

180.00 

30 

66 

-15.00 

1 5.  00 

180.  CO 

198.00 

60 

67 

-15.00 

1 5.  30 

198.00 

21 6.00 

60 

63 

-15.00 

1 5.  30 

21 6.00 

234. CO 

60 

69 

-15.00 

15.  00 

234.03 

252.00 

60 

’0 

-1 5.00 

15.  00 

252.00 

270.00 

20 

71 

- 1 5.0  0 

1 5.  00 

27  3.00 

286. CO 

60 

72 

-15.0  0 

15.00 

286. OC 

306.00 

60 

73 

-15.00 

15.  OO 

306.00 

324.00 

60 

74 

-15.00 

1 5.  00 

32  4 .00 

341.00 

60 

75 

-15.00 

15.  00 

342.00 

26C.C0 

30 

76 

- 30.0  0 

0.  3 

0.0 

16.00 

6C 

77 

-31.00 

0.  3 

1 8.00 

36.  CO 

60 

78 

- 30.00 

0.  3 

36.00 

54.00 

60 

79 

- 20.0  0 

0.  J 

* 54. OC 

72. CO 

60 

30 

-30.00 

0.0 

72. OC 

9C.  00 

30 

81 

-30.00 

0.  0 

90.00 

1 08. CO 

60 

82 

-30.00 

0.  3 

103.00 

126.00 

60 
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Figure  6-12.  Truncated  Sample  Output  From  CAT, 
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Figure  (>-13.  Sample  Output  From  CAT,  Run  Catalog  Summary  (1  of  2) 
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Figure  6-13.  Sample  Output  From  CAT,  Hun  Catalog  Summary  (2  of  2) 
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II 


JOB  CARD  GOES  HERE 


//^EXEC^FORTRANH, REGION=330K 
//SYSIN^  DD^  DSN=CAT. FORT, DI SP=SHR 


/ ** 

r% 

//^EXEC^ LOADER, REGI ON= 350K , PARM= * S I ZE= 350000' 
/ /FT30F001^  DD^  DSN=SSSCR1, UNIT=DISK, 


//^SPACE  = C1640,[2000|),  DI  SP=CNEW , PASS)  , DCB=(DSORB=DA) 


1//FT50FC01  * DD  ^DSN  = S5SCR2,UNIT  = Dr‘SK, 


// 


u 


SPACE  = CTRK,|100D  ,DC3  = CRECFM=FB.LRECL=80  ,BLKS  IZE  = 7280)  , 


//^DISP=(NEW,PASS) 

4 =L 


ks 


k5 


/ / FT|5 2|F001  DD  * DSN= INPUTCAT . DATA, DI SP=SHR 


5 //FTSOFOOl^  DD  * UNIT  = 2400-9  . VOL=SER=lxxxxx~x1, 


/7^LABEL=Cp,  B L P ) , D I S P = C N E W , K E E P ) , 

//feSbSDC3  = CRECFM=F3,  LRECL  = l640,BLKSIZE  = o560) 


fef 


/ /FT90F001  DD  DSN  AT  FINAL.  DATA|,  D I SP  = SH  R 

/« 

II 


NOTES 

1 - THE  2000  REFERS  TO  THE  NUMBER  OF  LOGICAL  RECOROS  IN  THE  FILE.  IT  MUST  BE  AT  LEAST 

AS  LARGE  AS  THE  NUMBER  OF  LOGICAL  RECORDS  ASSIGNED  TO  FILE  30  IN  THE  DEFINE  FILE 
STATEMENT  IN  THE  MAIN  PROGRAM  (SEE  SECTION  6. 6. 1.3.3) 

2 - THIS  FILE  IS  INCLUDED  ONLY  IF  MODIFY  WILL  BE  EXECUTED 

3 - THE  NUMBER  OF  TRACKS  REQUIRED  FOR  FILE  50  IS  EQUAL  TO  THE  NUMBER  OF  STARS  IN 

THE  INPUT  CATALOG  DIVIDED  BY  91 

4 - THE  FILE  NUMBER  FOR  THIS  FILE  MUST  EQUAL  THE  NAMELIST  PARAMETER  IFILE  THE 

DEFAULT  VALUE  OF  52  IS  SHOWN. 

5-  THIS  FILE  IS  INCLUDED  ONLY  IF  OUTPUT  IS  SEQUENTIAL  IT  IS  NOT  NEEDED  IN  STAR 

COUNTING  MODE.  THIS  OD  STATEMENT  IS  FOR  A TAPE,  BUT  SEQUENTIAL  DISK  OUTPUT  IS 
ALSO  POSSIBLE. 

6 - xxxxxx  IS  REPLACED  BY  A TAPE  NUMBER. 

7 - THIS  INDICATES  OUTPUT  ON  THE  FIRST  FILE  OF  THE  TAPE.  ALTER  THIS  NUMBER  AS  NEEDED. 

8 - THIS  FI  LE  IS  INCLUOED  FOR  OIRECT -ACCESS  OUTPUT  ONLY  IT  IS  NOT  NEEDED  IN  STAR 

COUNTING  MODE. 

9 - THIS  DATASET  NAME  MAY  BE  REPLACED  AS  NEEDED  IT  IS  ASSUMED  TO  8E  A PREVIOUSLY 

CATALOGED  DATA  SET  OF  DCB=(DSORG-DA)  AND  SPACE  =0 640,xxxx),  WHERE  xxxx  IS  AT 
LEAST  AS  LARGE  AS  THE  NUMBER  OF  LOGICAL  RECORDS  ALLOCATED  TO  FILE  90  IN  THE 
DEFINE  FILE  STATEMENT  IN  THE  MAIN  PROGRAM.  (SEE  SECTION  6 6 1 3 3) 


Figure  6-14. 


JCL  To  Execute  Program  CAT  From  Source  Library 
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6.  6.  4 Overlay  Considerations 

Overlay  is  not  useful  within  CAT  because  there  are  no  major  subroutines. 

6.  6.  5 System  Resources 

CAT  is  designed  to  run  on  the  IBM  S/360-95  computer  under  OS/HASP  or 
OS/MVT.  CAT  requires  330K  bytes  of  main  storage  for  the  FORTRAN  H 
compiler  and  350K  bytes  for  LOADER. 

Temporary  disk  storage  is  needed  for  files  30  and  50.  File  30  requires  N/4 
tracks,  where  N is  the  number  of  logical  records  allocated  file  30  in  the 
DEFINE  FILE  statement  in  the  MAIN  program.  This  file  holds  the  sorted  data 
overflowing  from  core  arrays  during  the  sorting  process  and  therefore  must 
contain  enough  room  for  all  star  data  for  50  zones.  File  50  is  needed  only  if 
MODIFY  is  to  be  called.  It  requires  M/91  tracks  of  temporary  disk  storage 
where  M is  the  number  of  stars  in  the  input  catalog. 

If  output  is  direct-access,  an  additional  data  set  is  required  for  file  90.  The 
data  set  requires  L/4  tracks  of  disk  storage,  where  L = the  number  of  logical 
records  allocated  file  90  in  the  DEFINE  FILE  statement  in  the  MAIN  program. 

L can  be  determined  by  running  CAT  in  star  count  mode  (Sections  6.  2.  2. 2 
and  6. 6.  2.  2). 

6.  6.  6 Execution  Time  Estimates 

The  central  processing  unit  (CPU)  and  input/output  (I/O)  execution  times  re- 
quired to  run  program  CAT  have  been  investigated  for  the  following  situation. 

An  input  star  catalog  on  disk  with  DCB=(RECFM=FB,  LRECL=30,  BLKSIZE= 
7280)  was  used.  CAT  was  executed  in  catalog  generation  mode,  with  the  limited 
printout  option  TFCAT=0)  and  MODIFY  was  executed  to  convert  right  ascension 
and  declination  to  the  G.  I.  unit  vector. 
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The  CPU  and  I/O  times  required  for  direct-access  (disk)  output  under  OS/HASP 
can  be  approximated  by 


S 

CPU  = 1000Q  (0.  34  + 0.  0072)  Seconds 

g 

I/O  = 3.30  + 1.17  x Seconds 

10000 

where  CPU  = CPU  time  in  seconds  for  low  speed  core 
I/O  = 1/0  time  in  seconds 

S = number  of  stars  in  input  catalog 
Z = number  of  zones  generated  (see  Table  6-1) 

For  sequential  (tape)  output, 

O 

CPU  = 10000  (O'  69  + 0‘  008°z)  Seconds 

g 

I/O  = 2.  00  + 0.  37  x 1Qqqq  Seconds 

For  both  direct-access  and  sequential  (tape)  output,  the  I/O  time  is  only  a weak 
function  of  the  number  of  zones.  Neither  CPU  nor  I/O  time  is  significantly  de- 
pendent on  the  number  of  words  of  data  per  star. 

Printout  of  the  entire  catalog  (IFCAT=1)  requires  approximately  0.  5 minute 
more  CPU  and  0. 3 minute  more  I/O  per  10, 000  stars  in  the  input  catalog. 

Star  counting  mode  uses  about  one-fourth  the  CPU  and  approximately  the  same 
I/O  as  sequential  (tape)  output  catalog  generation  jobs. 
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SECTION  7 - RUN  CATALOG  DATA  MANAGEMENT 


Routines  using  the  Run  Catalog,  specifically  program  LOOKAT,  reference  it 
by  reading  a direct-access  (disk)  version  of  the  Run  Catalog. 

When  the  Run  Catalog  is  created  by  program  CAT,  it  may  be  in  either  sequential 
(tape  or  disk)  or  direct-access  format.  The  normal  mode  of  operation  creates 
the  Run  Catalog  on  tape  in  sequential  format.  The  entire  Run  Catalog,  or  those 
portions  which  the  user  anticipates  needing  (which  may  be  referred  to  as  the 
"selected"  Run  Catalog),  are  then  loaded  onto  a direct-access  disk  file  by  pro- 
gram SWITCH.  This  procedure  provides  a tape  backup  for  the  disk  file  and 
allows  saving  of  disk  storage  when  only  portions  of  the  Rim  Catalog  will  be 
needed. 

7.  1 CAPABILITIES  OF  PROGRAM  SWITCH 
Program  SWITCH  has  two  basic  functions,  as  follows: 

® Copying  the  Run  Catalog,  or  portions  of  the  Run  Catalog,  from  one 
file  to  another,  simultaneously  converting  it  between  sequential  and 
direct-access  file  format,  if  desired 

o Selecting  portions  of  the  Run  Catalog  for  transfer  to  an  output  file 
In  addition,  SWITCH  permits  the  following: 

o Execution  in  foreground  mode  under  timesharing  option  (TSO),  with 
monitoring  messages  output  to  the  TSO  terminal.  This  is  possible 
only  when  no  tapes  are  involved. 

o Simultaneous  processing  of  up  to  six  camera  mounting  positions  on 
the  spacecraft. 
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© Specification  of  Run  Catalog  zones  to  be  transferred  to  the  output 
file  by  any  of  the  following  methods : 

Specification  of  the  zone  numbers  to  be  transferred; 

Specification  of  an  array  of  camera  optical  axis  pointings;  or, 

Specification  of  the  spin  axis  pointing  and  camera  elevation 
angle  and  field  of  view;  this  results  in  all  zones  along  the  path 
taken  by  the  camera  optical  axis  during  one  spacecraft  rotation 
being  selected. 

© Printout  of  the  entire  (selected)  Run  Catalog. 

7.  2 PROGRAM  SWITCH  LOGICAL  FLOW 

Figure  7-1  is  a logical  flow  chart  for  program  SWITCH. 

NAMELIST  parameters  which  control  program  flow  are  read  from  an  input  file. 
The  NAMELIST  record  images  are  printed  to  provide  the  user  with  a convenient 
means  of  checking  his  input.  Since  some  input  files  cannot  be  rewound,  the 
NAMELIST  card  images  are  simultaneously  written  on  a temporary  disk  file. 
This  file  is  then  rewound  and  a regular  NAMELIST  read  performed.  NAMELIST 
parameter  values  are  checked  to  ensure  that  they  are  within  permissible  limits. 
If  they  are  not,  an  error  message  is  printed  and  SWITCH  stops.  A formatted 
output  of  all  relevant  NAMELIST  parameters  is  printed. 

Next,  the  first  record  of  the  input  file  (Run  Catalog)  is  read.  This  record  con- 
tains control  words  describing  the  format  of  the  Run  Catalog.  It  also  contains 
the  user-input  tit.e,  time,  and  NAMELIST  parameter  values  that  were  used  by 
program  CAT  to  generate  the  full  Run  Catalog.  This  information  is  printed  so 
that  the  user  can  determine  if  the  correct  input  catalog  is  being  used.  The  con- 
trol record  formats  are  discussed  in  Section  6.  *3.  2. 1.  3. 


--0 


SWITCH 


ORIGINAL  PAGE  fS 
Of  POOR  QUALITY 


Figure  7-1.  Logical  Data  Flow  for  Program  SWITCH  (1  of  4) 
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Figure  7-1.  Logical  Data  Flow  for  Program  SWITCH  (2  of  4) 
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Figure  7-1.  Logical  Data  Flow  for  Program  SWITCH  (4  of  4) 
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7.2.1  Zone  Selection 

SWITCH  determines  which  subcatalogs  to  write  on  the  output  file  by  computing 
the  IZONES  array,  which  contains  the  zone  selection  flags.  IZONES(I)  = 1 
if  subcatalog  number  I is  to  be  written  on  the  output  file.  If  it  is  not, 

IZONES  (I)  = 0 . 

If  the  entire  Run  Catalog  is  to  be  output,  IZONES(I)  is  set  to  1 for  all  subcata- 
logs. If  only  portions  of  the  Run  Catalog  are  to  be  output,  zone  selection  is 
performed  for  each  of  up  to  six  camera/spin  axis  combinations.  The  zones 
required  for  each  camera  are  flagged  with  a 1 in  the  IZONES  array. 

For  each  camera,  the  required  zones  may  be  selected  in  one  of  three  ways. 

• Case  1:  The  user  determines  which  zones  will  be  needed  by  some 
manual  technique  and  inputs  the  number  of  these  zones. 

• Case  2:  The  user  specifies  a spin  axis  pointing,  an  angle  between 
the  spin  axis  and  camera  optical  axis  (coelevation  angle),  and  a 
field-of-view  factor  as  defined  in  Section  7.3.  SWITCH  selects  the 
zones  necessary  for  all  camera  optical  axis  pointings  within  the 
path  taken  by  the  camera  optical  axis  during  a complete  space- 
craft rotation. 

• Case  3:  The  user  specifies  an  array  of  optical  axis  pointings. 
SWITCH  selects  the  zones  necessary  for  each  pointing  in  the  array, 
and  for  a user  input  field  of  view  about  the  pointing. 

Zone  selection  is  now  complete. 

The  subcatalog  pointer  array  defined  in  Section  6.6.2. 1.3  is  read  from  the  input 
file.  For  each  subcatalog  ir.  the  input  file,  the  array  IPOEXT  contains  the  num- 
ber of  the  first  logical  record  of  that  subcatalog.  A negative  value  in  IPOINT 
means  the  subcatalog  is  not  available  on  the  input  file. 
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If  zone  selection  was  performed,  the  IZONES  array  now  contains  a 1 for  each 
subcatalog  to  be  transferred  to  the  output  catalog.  If  selection  was  not  per- 
formed, IZONES  is  set  to  1 for  every  subcatalog  available  on  the  input  file  and 
is  set  to  0 for  the  unavailable  subcatalogs.  A summary  of  the  selected  zones 
is  printed  and  a right  ascension/declination  plot  showing  the  portion  of  the  sky 
they  cover  is  generated. 

SWITCH  ensures  that  every  zone  selected  for  output  is  available  on  the  input 
file.  If  one  or  more  is  not,  an  error  message  is  printed  and  SWITCH  stops. 

7.2.2  Creation  of  the  Output  Catalog 

SWITCH  creates  the  output  Run  Catalog  by  transferring  each  selected  subcatalog 
from  the  input  file  to  the  output  file. 

An  index  keeps  track  of  the  logical  record  number  being  written  on  the  output 
file.  The  pointer  array,  IPOINT,  is  set  to  the  output  file  logical  record  number 
for  the  first  subcatalog  record. 

If  the  zone  is  not  to  be  output,  but  is  present  on  the  input  file,  the  subcatalog 
is  read  from  the  input  file  without  being  written  on  the  output  file.  This  posi- 
tions the  input  device  to  the  start  of  the  next  subcatalog.  In  this  case,  the 
IPOINT  array  value  is  set  to  the  negative  of  the  next  output  record  number, 
thereby  indicating  that  the  zone  is  not  present. 

When  all  zones  have  been  processed,  the  IPOINT  array  is  written  on  the  second 
through  eighth  records  of  a direct-access  output  file,  or  as  the  last  seven 
records  of  a sequential  file. 

If  requested,  the  output  file  is  rewound,  read,  and  a printed  output  produced. 
The  message  "END  OF  CATALOG"  is  printed  and  SWITCH  stops. 
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7.3  MATHEMATICAL  SPECIFICATIONS 
7.3.1  Calculating  Optical  Axis  Pointings 

The  zones  that  SWITCH  transfers  to  the  output  file  are  selected  from  a set  of 
zone  numbers  directly,  or  from  optical  axis  pointings.  The  pointings,  in  turn, 
can  be  specified  in  either  of  two  ways,  defined  in  Section  7.2.1  as  Case  2 and 
Case  3.  Case  3 degenerates  to  Case  2 with  a coelevation  angle  of  0.0  degrees. 
Therefore,  this  section  shows  only  how  the  optical  axis  pointings  are  generated 
for  Case  2. 


The  camera  optical  axis  path  is  calculated  at  small  discrete  intervals  as  it 
sweeps  out  a path  about  the  spin  axis.  Additional  paths  are  computed  at  inter- 
vals of  half  the  zone  height  until  limits  are  reached.  The  limits  are  computed 
from 


limits  = 6 = FOV  ' (7-1)  ’ 

where  0 = angle  between  the  spin  axis  and  the  camera  optical  axis 
FOV  = radius  of  the  field  of  view  (NAMELIST  parameter  FOV) 

The  following  procedure  is  used  to  calculate  the  discrete  camera  optical  axis 
pointings  in  G.I.  coordinates  for  a band  with  coelevation  angle  a . Each  addi- 
tional band  is  computed  the  same  way,  with  0 appropriately  altered. 

Let  a,  6 = spin  axis  right  ascension  and  declination,  respectively 

0 = angle  between  the  spin  axis  and  the  camera  optical  axis 

j3  = angular  separation  between  the  discrete  optical  axis  points  to  be 
calculated 

Define  a coordinate  system  such  that  the  z'-axis  is  the  spin  axis.  The  x'-  and 
y'-axes  are  arbitrary  subject  to  the  constraints  that  the  coordinate  system  be 
right-handed  and  orthonomal,  as  shown  in  Figure  7-2. 
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Figure  7-2.  Spin  Axis  Coordinate  System 
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Consider  a set  of  optical  axis  pointings  in  this  coordinate  system: 


where 


x!  = cos  o.  sin  6 
1 i 


v!  = sin  c o.  sin  0 

" l i 


z!  = cos  0 

l 


N 


o.  = (i  - 1) 


0 

sin  0 


i = 1,  . 


N 


(7-2) 


(7-3) 


This  yields  a set  of  points  in  the  x’,  y',  z'  coordinate  system  (the  spin  axis 
coordinate  system)  with  angular  separation  /3  . Define  N such  that 


N 


2tt  sin  8 

0 


(7-4) 


Round  N up  to  the  next  highest  integer  and  ensure  that  sin  0 in  Equations  (7-3) 
and  (7-4)  is  set  to  0. 01  if  it  is  actually  less  than  that.  N is  now  the  number  of 
pointings  needed  for  one  complete  spacecraft  rotation,  and  (x!  , y!  , z!)  , for 
i = 1,  . . . , N , are  the  required  pointings  in  the  spin  axis  frame.  Define  A as 
the  matrix  that  transforms  a vector  from  the  spin  axis  coordinate  system  to  the 
G.I.  sj'Stem. 


A = 


cos  a sin  6 
sin  a sin  6 
-cos  6 


-sin  a cos  a.  cos  5 
cos  a sin  a cos  5 
0 sin  6 


(7-3, 
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where  a = spin  axis  right  ascension 
6 = spin  axis  declination 

Then: 


[x  y z J = [A] 


x' 

y' 

z' 


i = 1,  ....  N 


(7-6) 


where  [x,  y,  z]  are  the  required  optical  axis  pointings  in  the  G. I.  frame. 
7.3.2  Zone  Number  Calculation 

Given  an  optical  axis  pointing,  SWITCH  determines  the  number  of  the  zones 
needed  to  access  stars  in  its  vicinity. 

Recall  that  the  sky  was  divided  into  overlapping  rows  defined  by  a range  of 
declination  (Section  6.3.2).  A star  is  in  row  j provided  that 


6.  - ws  6*  £ 6.  (7-7) 

J J 


where  6*  = declination  of  the  star  in  degrees 

6.  = northern  limiting  declination  of  the  jth  row  in  degrees,  obtained 
from  the  Run  Catalog  header  records  (see  Section  6.  6.2. 1) 

W = declination  zone  height 

Each  row  is  divided  into  zones.  The  arc-width  of  the  zones  in  each  row  is 
defined  in  the  Run  Catalog  header  records. 
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Zones  are  numbered  sequentially  starting  at  row  1,  and  within  a row,  sequen- 
tially in  order  of  increasing  right  ascension.  The  zone  number,  Z , for  a par- 
ticular optical  axis  pointing  , 6^  is, 

Z=N.  + (aVAA.)  (7-8) 

j 0 y 


truncated  to  an  integer 

where  = right  ascension  of  the  optical  axis  in  degrees 

AA.  = the  right  ascension  width  of  the  zones  in  the  jth  row,  in  degrees 
^ and  obtained  from  the  Run  Catalog  header  records  (see  Sec- 
tion 6.  6.  2. 1) 

j = the  row  number,  which  is  given  by 

2.0  (90.0  - 6q)\ 


where  (...)  = the  greatest  integer  contained  in  the  expression 

W = the  zone  height,  in  degrees,  also  obtained  from 
the  Run  Catalog  header  records 

Z is  the  number  of  the  zone  whose  center  is  nearest  the  optical  axis  pointing. 
Except  for  circumpolar  zones,  two  zones  adjacent  in  right  ascension  are  com- 
bined to  form  a region  whose  right  ascension  arc-width  at  least  equals  its 
height.  To  calculate  the  number  of  the  remaining  (adjacent)  zone,  the  central 
right  ascension  of  zone  number  Z is  computed  from 

C = (Z  - N.j  AA.  0.  5 AA.  (7-10) 

J J J 

If  aQ  < C , the  remaining  zone  is  the  one  adjacent  to  zone  number  Z on  the 
side  of  decreasing  right  as  :ensicn.  If  aQ  2 C , the  remaining  zone  is  on  the 
side  of  increasing  right  ascension. 
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7.4  BASELINE  DIAGRAM  AND  UNIT  DESCRIPTION 


7.4.1  Baseline  Diagram 

Figure  7-3  is  a baseline  diagram  of  program  SWITCH. 

7.4.2  Unit  Descriptions 

Unit  descriptions  of  programs  SWITCH  and  LCHEK2  are  presented  in  Sec- 
tions 7. 4.  2.1  and  7. 4.  2. 2,  respectively.  An  explanation  of  the  tabular  formats 
used  in  these  sections  is  given  in  Section  2.  4. 1.  Appendix  E is  a FORTRAN 
compiler  listing  of  SWITCH. 

The  following  is  an  index  to  all  program  SWITCH  modules. 


Module 

Reference  Page 

DCLOSE 

Reference  35 

DREAD 

Reference  35 

DWRITE 

Reference  35 

SWITCH 

7-16 

LCHEK2 

7-19 

7-14 
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’these  ARE  DIRECT-ACCESS  INPUT/OUTPUT  ROUTINES.  SEE  REFERENCE  35  FOR  A DESCRIPTION. 


Figure  7-3.  Baseline  Diagram  of  Program  SWITCH 
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7.  4.  2. 1 Program  SWITCH 

DESCRIPTION:  SWITCH  copies  a Run  Catalog  from  one  file  to  another.  Con- 
version between  sequential  and  direct-access  file  organization  may  be  performed 
during  the  copy.  SWITCH  allows  the  copying  of  only  selected  subcatalogs  as 
specified  by  NAMELIST  parameters. 

CALLING  SEQUENCE:  None  (SWITCH  is  the  main  program) 

COMMON  AREAS  REFERENCED:  FERMSG 

EXTERNAL  REFERENCES:  DCLOSE,  DREAD,  D WRITE,  LCHEK2 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  15  is 
NAMELIST  input;  16  is  printed  output;  125  is  temporary  internal  storage; 

INFILE  is  the  input  Run  Catalog  file;  IOUTFL  is  the  output  Run  Catalog  file; 
and  ITSOFL  is  an  optional  file  for  TSO  monitoring  if  SWITCH  is  operated  in 
TSO  foreground  mode.  15,  16,  and  125  are  defined  in  a DATA  statement  to  be 
5,  6,  and  25,  respectively.  INFILE,  IOUTFL,  and  ITSOFL  are  NAMELIST 
parameters  with  default  values  of  40,  41,  and  16,  respectively. 

ERROR  MESSAGES: 

'NAMELIST  ERROR  - IZONES  (xxxx)  = yyyyyy  (ONLY  0 OR  1 IS  ALLOWED)'  — 
The  IZONES  array  determines  which  subcatalogs  will  be  output.  IZONES(I)  = 0 
means  that  the  ith  subcatalog  will  not  be  output;  IZONES(I)  = 1 means  that  it  will 
be  output.  Other  values  are  illegal.  The  user  should  check  NAMELIST  input 
values  fcr  IZONES.  SWITCH  terminates  execution. 

'NAMELIST  ERROR  - CAMALP  (xxxx,  y)  = zzzzzz.zzzzz  (ALLOWED  RANGE 
IS  0.0  TO  360.0)'. 

’NAMELIST  ERROR  - CAMDEL  (xxxx,  y)  = ztrzzzz.  zzzzz  (ALLOWED  RANGE 
IS  -90.  0 TO  -90.  0)’ — The  camera  optical  axis  right  ascension  and  declinations 
may  be  input  via  NAMELIST  into  the  CAM4.LP  and  CAMDEL  arrays.  The  units 
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are  degrees.  Only  values  between  the  limits  stated  are  valid.  The  user  should 
check  NAMELIST  input.  SWITCH  terminates  execution. 

'NAMELIST  ERROR  - INFILE  = xxxx  WHICH  IS  A SYSTEM  FILE'. 

'NAMELIST  ERROR  - IOUTFL  = xxxx  WHICH  IS  A SYSTEM  FILE'. 

'NAMELIST  ERROR  - ITSOFL  = xxxx  WHICH  IS  A SYSTEM  FILE’. 

'NAMELIST  ERROR  - INFLIE  = IOUTFL'. 

'NAMELIST  ERROR  - INFILE  = ITSOFL'. 

'NAMELIST  ERROR  - IOUTFL  = ITSOFL'— The  FORTRAN  files  INFILE, 
IOUTFL,  and  ITSOFL  must  all  be  different  and  must  also  differ  from  files  15, 

16,  and  125.  The  user  should  check  NAMELIST  input  for  INFILE,  IOUTFL, 
and  ITSOFL  and  the  DATA  statement  for  15,  16,  and  125.  SWITCH  terminates 
execution. 

'FATAL  ERROR  - OVERFLOW  OF  THE  CAMALP  AND  CAMDEL  ARRAYS'— 
The  arrays  are  dimensioned  for  1100.  During  calculation  of  the  optical  axis 
pointings,  more  than  1100  were  generated.  The  NAMELIST  parameter  TOLER, 
which  controls  the  spacing  of  these  points,  is  too  small.  SWITCH  terminates 
execution. 

'FATAL  ERROR  - ONE  OR  MORE  SUBCATALOGS  NEEDED  FOR  OUTPUT  WAS 
NOT  AVAILABLE  IN  THE  INPUT  CATALOG'— The  required  subeatalog(s)  which 
are  misssing  from  the  input  file  are  flagged  in  a zone  summary  printout  on 
FORTRAN  data  set  16  by  '**********ERROR**********'  as  the  last  field.  The 
user  should  respecify  the  output  zones  or  obtain  a more  complete  input  catalog. 
SWITCH  terminates  execution. 
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'READ  ERROR  OCCURRED  ON  A DIRECT-ACCESS  FILE.  THE  FOLLOWING 
IS  THE  DATA  ERROR  MESSAGE  BLOCK. 

zzzzzzzz  mm  aaaaaaaa 

AAAAAAAA  ZZZZZZZZ  ZZZZZZZZ 

ZZZZZZZZ  ZZZZZZZZ’ 

The  Z,  I,  and  A fields  indicated  are  hexadecimal,  integer,  and  alphameric  in- 
formation, respectively,  from  the  Direct  Access  Input/Output  (DAIO)  error 
return  fields.  The  user  must  determine  what  error  occurred  by  consulting 
Reference  35  under  "Data  Management  Techniques”  and  take  the  appropriate 
action. 
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LCHEK2 


7.4.  2.2  Subroutine  LCHEK2 

DESCRIPTION:  LCHEK2  checks  values  of  NAMELIST  parameters  against  their 
permissible  range. 

CALLING  SEQUENCE:  Subroutine  LCHEK2  (WORD,  FVAL,IVAL,IA,IBf  FA, 

FB,  ITY,  IFTSO,  ITSOFL) 

COMMON  AREAS  REFERENCED:  None 
EXTERNAL  REFERENCES:  None 
CALLED  BY:  SWITCH 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
printed  output.  ITSOFL  is  optional  TSO  terminal  output  if  the  program  is  run 
in  TSO  foreground  mode. 

ERROR  MESSAGES: 

'NAMELIST  ERROR  - VALUE  OUT  OF  ALLOWED  RANGE  xxxxxx  = yyyyyy 
(ALLOWED)  zzzzzz  - wwwwww' — NAMELIST  variables  must  be  within  the 
specified  limits.  A STOP  is  executed  within  subroutine  LCHEK2. 
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LCHEK2 
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7.  5 COMMON  AREA  DESCRIPTIONS 

The  only  COMMON  area  used  by  program  SWITCH  or  its  subroutines  is 
/FERMSG/  which  is  described  below. 

NAME:  FERMSG 

DESCRIPTION:  FERMSG  contains  the  error  return  fields  from  the  DAIO  read 
routine,  DREAD. 

FORM:  COMMON  /'FERMSG/  IMES(26) 

REFERENCED  BY:  DREAD,  SWITCH 
DEFINITION  OF  VARIABLES: 


Name 

Type 

Description 

IMES(l) 

4-byte  hexadecimal 

DAIO  error  return  field  (see 
Reference  35) 

IMES(2) 

1*4 

DAIO  error  return  field  (see 
Reference  35) 

IMES(3) 

4-byte  alphameric 

DAIO  error  return  field  (see 
Reference  35) 

IMES(22) 

4-byte  alphameric 

DAIO  error  return  field  (see 
Reference  35) 

IMES(23) 

4-byte  hexadecimal 

DAIO  error  return  field  (see 
Reference  35) 

IMES(26) 

4 -byte  hexadecimal 

DAIO  error  return  field  (see 

Reference  35) 
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7.6  USER'S  MANUAL 

This  subsection  will  enable  the  user  to  create  the  proper  NAMELIST  input, 
interpret  the  resulting  output  from  program  SWITCH,  and  formulate  the  appro- 
priate Job  Control  Language  (JCL). 

7.6.1  Input  to  Program  SWITCH 

Input  to  SWITCH  consists  of  a NAMELIST  and  an  input  Run  Catalog.  In  addition, 
the  user  may  have  to  modify  one  statement  in  the  main  routine. 
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The  NAMELIST  parameters  in  &SWITIN  and  their  default  values  are  presented 
in  the  following  list  which  adheres  to  the  format  stated  in  Section  2.  4.  3.  Mul- 
tiple NAMELISTs  cannot  be  used  in  program  SWITCH. 


Name 

Type 

Default 

Description 

IMODE 

1*4 

2 

File  data  organization  flag: 

= 1,  input  and  output  are  sequential 
= 2,  input  sequential,  output  direct- 
access 

= 3,  input  direct-access,  output 
sequential 

= 4,  input  and  output  are  both  direct- 
access 

IFSLCT 

1*4 

0 

Subcatalog  selection  flag: 

= 0,  copy  the  entire  input  catalog  onto 
the  output  file.  This  overrides 
the  other  NAMELIST  parameters 
that  specify  which  subcatalogs 
are  to  be  transferred 
= 1,  use  selection  logic  to  determine 
which  subcatalogs  to  put  on  the 
output  file 

IFTSO 

1*4 

0 

Interactive  capability  flag: 

= 0,  interactive  capability  OFF 
= 1,  interactive  capability  ON 

IFPRNT 

1*4 

0 

Print  flag: 

= 0,  do  not  print  full  output  catalog 
= 1,  print  full  output  catalog 

INFILE 

1*4 

0 

Input  file  number 

IOUTFL 

1*4 

0 

Output  file  number 

ITSOFL 

1*4 

16 

Interactive  file  number  for  moni- 
toring messages  (when  IFTSO  = 1 
only) 
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&SWITIN 


Name  Type  Default 


Description 


TOLER1  R*4  1.0 

NCAMPT(6)  1*4  6*1 


FOV^)1  R*4  6*0.0 


ISLFLG^)1 


1*4  6*2 


IZONES(2SOO)' 


1*4 


2800x0 


Arc  distance  in  degrees  between 
camera  optical  axis  pointings  (for 
IFSLCT  = 1 only) 

NCAMPT(I) — for  the  ith  camera, 
number  of  valid  points  being  stored 
in  the  CAMALP  and  CAMDEL  ar- 
rays (for  ISLFLG  = 3 only) 

FOV(I) — for  the  ith  camera,  the 
total  height  of  the  band  to  be  se- 
lected in  degrees.  This  should  be 
the  sum  of  the  field-of-view  radius, 
and  the  maximum  anticipated  pre- 
cession, nutation  and  secular  motion 
of  and  uncertainty  in  the  spin  axis 
position  (for  ISLFLG  = 2 or  3 only) 

ISLFLG(I) — selection  mode  flag  for 
the  ith  camera 

= 1,  the  required  subcatalogs  are 
flagged  in  the  NAMELIST 
array  IZONES 

= 2,  the  path  of  the  camera  optical 
axis  is  determined  from  the 
spin  axis  position  and  the  angle 
between  the  spin  axis  and  the 
camera  optical  axis 
= 3,  the  path  of  the  camera  optical 
axis  is  specified  in  the 
NAMELIST  arrays  CAMALP 
and  CAMDEL 

IZONES(I) — subcatalog  selection 
flag  for  the  ith  subcatalog 
(ISLFLG  = i only, 

= 0,  do  not  copy  subcatalog  to  output 
file 

= 1,  copy  subcata.ug  to  output  file 


Required 


when  IFSLCT 


1. 
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&SWITIN 


Name 

Type 

Default 

Description 

SPINAL^)1 

R*4 

6*0.0 

SPINAL(I) — right  ascension  of  the 
spin  axis  of  the  ith  camera  in  de- 
grees (ISLFLG  = 2 only) 

SPINDLY)1 

R*4 

6*90.0 

SPINDL(I) — declination  of  the  spin 
axis  of  the  ith  camera  in  degrees 
(ISLFLG  = 2 only) 

COELEV(6)X 

R*4 

6*90.0 

COELEV(I) — angle  between  the  spin 
axis  and  the  ith  camera  optical  axis 
in  degrees  (ISLFLG  = 2 only) 

CAMALP 
(1100, 6)1 

R*4 

6600*0.0 

CAMALP(J,I) — jth  right  ascension 
of  the  optical  axis  for  the  ith  cam- 
era, in  degrees  (ISLFLG  = 3 only) 

CAMDEL 
(1100, 6)1 

R*4 

6600*0. 0 

CAMDEL(J,I) — jth  declination  of 
the  optical  axis  for  the  ith  camera, 
in  degrees  (ISLFLG  = 3 only) 

NCAM1 

1*4 

1 

Number  of  cameras  to  be  considered 
(1  £ NCAM  £ 6) 

7.  6. 1. 2 Input  Run  Catalog 


SWITCH  requires  an  input  Run  Catalog  generated  either  by  program  CAT  or  by 
a previous  execution  of  program  SWITCH.  The  Run  Catalog  may  be  in  either 
sequential  or  direct-access  format.  The  format  of  the  Run  Catalog  is  presented 
in  Section  6.  6.2.1. 

7.  6. 1 . 3 Modifications  to  SWITCH 

It  is  envisioned  that  the  user  may  wish  to  alter  SWITCH  to  reset  the  DATA 
statement  defining  file  numbers  for  NAMELIST  input,  printed  output,  and  tem- 
porary storage. 

To  alter  the  file  numbers,  the  following  statement  (sequence  number  00005900) 
may  be  changed: 


DATA  15,16,125/5,6,25/ 


Required  when  IFSLCT  = 1. 
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7.6.2  Output  From  Program  SWITCH 

SWITCH  produces  a sequential  or  direct-access  output  Run  Catalog  and  printed 
output. 

7. 6.  2. 1 Output  Run  Catalog 

SWITCH  will  produce  a Run  Catalog  that  is  structurally  the  same  as  that  pro- 
duced by  CAT  (see  Section  6.  6.2. 1).  However,  it  may  contain  only  a portion 
of  the  subcatalogs  present  on  the  input  Run  Catalog.  Missing  subcatalogs  are 
flagged  in  the  pointer  array  (see  IPOINT,  in  Section  6.  6. 2. 1.3)  by  having  the 
number  of  their  first  logical  record  set  to  the  negative  of  what  it  would  have 
been  were  the  subcatalog  present. 

All  control  records  and  the  subcatalog  internal  format  are  the  same  as  the  out- 
put Run  Catalog  from  program  CAT  (Section  6. 6.  2. 1.  3).  The  catalog  may  be 
either  sequential  or  direct  access. 

7.  6.  2.  2 Printed  Output  From  SWITCH 

SWITCH  produces  the  following  printed  output  to  assist  in  evaluating  the  pro- 
gram performance: 

• A listing  of  NAMELIST  card  images. 

© A formatted  listing  of  the  NAMELIST  parameters. 

• A series  of  self-explanatory  error  messages  concerning  NAMELIST 
parameter  values.  If  the  printout  ends  here,  correct  the  indicated 
error  and  rerun  the  job.  The  meaning  of  each  error  is  given  in  the 
unit  descriptions,  Sections  7.4.  2.1  and  7. 4.  2.  2. 

• The  title  and  NAMELIST  parameters  which  were  used  by  program 
CAT  to  create  the  original  run  catalog. 

• A summary  of  the  zones  including  zone  number,  limiting  right  ascen- 
sions and  declinations,  the  number  of  the  first  logical  record  on  the 
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input  file  for  that  zone,  and  the  "YES/NO"  comments  indicating  if 
the  subcatalog  was  present  on  the  input  file  and  if  it  will  be  written 
on  the  output  file. 

o An  error  message  if  a subcatalog  requested  for  output  is  not  avail- 
able on  the  input  file.  If  this  occurs,  the  printout  will  end  here. 
Change  either  the  input  file  or  the  requested  output. 

o A right  ascension/declination  plot  of  the  zones  selected  for  output. 

• A printout  of  the  entire  output  Run  Catalog,  if  requested,  including 
row  definition  parameters,  the  pointer  array  and  the  catalog  data 
for  each  star  in  each  zone. 

• If  the  program  terminates  normally,  the  message  "END  OF  CATA- 
LOG.” 

7.6.3  Job  Control  Language 

SWITCH  may  be  run  from  a FORTRAN  source  or  a load  module.  Figure  7-4 
presents  the  JCL  needed  to  compile  and  execute  SWITCH. 

7.6.4  Overlay  Considerations 
Program  SWITCH  cannot  be  overlaid. 

7.6.5  System  Resources  Needed 

SWITCH  requires  325K  bytes  of  core  storage  for  a FORTRAN-H  compile  and 
300K  bytes  in  the  GO  step. 

Two  tracks  of  temporary  disk  storage  are  required  for  file  125. 

CPU  times  required  for  executions  are  less  than  one-half  minute  for  catalogs 
containing  50,  000  stars  or  less.  I/O  times  required  for  execution  are  approxi- 
mately the  same  as  those  needed  by  program  CAT  (see  Section  6.6.  5). 
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//  . . . JOB  CARD  GOES  HERE  . . . 

//  EXEC  FORTRANH,  REG  I ON= 22 5K, PARM= ' XRE F * 


//SYS  I N DD  DSN  = [SSSWITCHl  , DI SP=(OLD, PASS) , UNIT=DISK 

//  dcb=(recfm=fb, lrecl=8o,  blksize=728o) 


/" 


//EXEC  LOADER,  REGION=300K, PARM= 1 SIZE-300000' 

// FT25F001  DD  DSN=SSSCR,DCB=CRECFM=FB,LRECL=iOO,BLKSIZE= 
//  UNIT=DISK,SPACE=(TRK,2), DISP=CNEW,PASS) 

, space=ci6ao,  proop , 


// FTJ1F001  DD  DSN= 


xxxxxxxx 


77  DISP=C  |new,  catalog]  ),  DCB=(DSORG=DA),  unit=disk 
//F#2]F001  DD  UNIT: 


2 a 0 0 - 91 , VOL  = SER=XXXXXX,  LABEL=(  1,  BLP)  , 


7 

5 

8 


//  DISP  = COLD, KEEP), DCB=CRECF.M=FB,LRECL=1640,BLKSIZE=S560) 
/ /DAT A5  DD" 

SSWI TIN 
IM0DE=|2J, 


INFI  LE=W2l. 
I FS  LCT=(0J, 


I FPRNT  = 10J 
END 


/** 


NOTES 

1 - DATA  SET  NAME  FOR  PROGRAM  SOURCE 

- OUTPUT  RUN  CATALOG  DATA  SET  NAME 

- NUMBER  OF  LOGICAL  RECORDS 

- IF  THE  DATA  SET  IS  OLD.  MAKE  THIS  PARAMETER  'OLD.  KEEP'. 

NOTE  DIRECT-ACCESS  DATA  SETS  MUST  ALWAYS  BE  NEW 

5 - INPUT  FILE  HAS  8EEN  RESET  TO  42  FROM  THE  DEFAULT  VALUE  OF  40 

6 - OUTPUT  S ON  TAPE.  DISK  IS  ALSO  PERMISSA8LE 

7 - INPUT  IS  SEQUENTIAL.  OUTPUT  IS  DIRECT-ACCESS 

8 - SWITCH  WILL  SELECT  ALL  ZONES  IN  THE  INPUT  CATALOG 

9 - DO  NOT  PRINT  AN  OUTPUT  CATALOG 


Figure  7-4.  Job  Control  Language  for  Program  SWITCH 
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SECTION  8 - ACCESSING  THE  RUN  CATALOG 


The  user  interfaces  with  the  complete  or  selected  SKYMAP  Run  Catalog  by 
using  the  subroutines  of  program  LOOKAT. 

LOOKAT  performs  two  functions — accessing  the  Run  Catalog,  and  statistical 
analysis  of  the  Run  Catalog.  The  groups  of  subroutines  used  for  these  purposes 
are  called  the  Access  Module  and  the  Statistics  Module,  respectively. 

This  section  discusses  the  Access  Module  of  LOOKAT;  Section  9 presents  in- 
formation on  the  additional  subroutines  of  the  Statistics  Module. 

3.1  ACCESS  MODULE  CAPABILITIES 

The  capabilities  of  the  LOOKAT  Access  Module  are  as  follows: 

• It  obtains  star  data  from  a direct-access  Run  Catalog  created  by 
program  CAT  (or  program  SWITCH ). 

o It  creates  a star  catalog  in  core  (the  Core  Catalog)  from  this  data 
according  to  user  specification. 

• It  creates  Core  Catalogs  covering  any  of  the  following: 

A circular  region  of  the  sky  ("cap")  of  any  user-specified 
radius  about  any  designated  pointing. 

A "band"  of  the  sky  of  any  user-specified  height  about  any 
great  or  small  circle. 

A "wedge"  of  the  sky  of  any  user-specified  height  about  any 
arc  of  any  great  or  small  circle  (i.e. , a slice  of  the  bandi. 

Figures  3-1,  8-2,  and  8-3  depict  areas  covered  by  typical  cap,  band, 
and  wedge  Core  Catalogs,  respectively. 

• Optionally,  it  excludes  stars  from  the  Core  Catalog  if  they  are  dim- 
mer than  any  user-specified  limit. 
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Figure  8-1.  Region  Covered  by  a Typical  Cap  Core  Catalog 
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Figure  8-2.  Region  Coveted  by  a Typical  Band  Core  Catalog 
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Figure  8-3.  Region  Covered  by  a Typical  Wedge  Core  Catalog 
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• Optionally,  it  computes  azimuths  in  a spacecraft  coordinate  system 
("longitudes'')  for  all  band  or  wedge  Core  Catalog  stars. 

o Optionally,  it  sorts  band  or  wedge  Core  Catalog  stars  in  order  of 
increasing  longitude. 

• It  obtains  all  information  from  the  Run  Catalog  header  records  nec- 
essary to  read  the  Run  Catalog  (see  Section  6. 6. 2. 1. 3). 

• It  allows  specification  of  the  great  or  small  circles  used  to  define 
the  region  of  the  sky  covered  by  band  and  wedge  Core  Catalogs  by- 
user  input  of 

A spin  axis 

The  angle  between  the  spin  axis  and  the  desired  great  or  small 
circle  (coelevation  angles) 

The  size  of  the  sensor  field  of  view 

• It  allows  specification  of  the  desired  arc  of  the  great  or  small  circle 
referred  to  above  in  connection  with  the  definition  of  the  wedge  Core 
Catalog  by  user  input  of 

A starting  or  central  pointing  anywhere  on  the  desired  great 
or  small  circle 

The  difference  in  longitude  between  the  desired  starting  and 
final  pointings  on  the  great  or  small  circle  (the  "range") 

8.2  ACCESS  MODULE  LOGICAL  FLOW 

The  Access  Module  does  not  have  a main  routine.  Three  of  its  subroutines  are 
intended  to  be  used  as  driver  routines  for  the  rest  of  the  LOOKAT  subroutines. 
These  three  subroutines — FETCH,  BAND,  and  SLICE — are  intended  to  be  in- 
serted in  the  user's  program  as  CALL  statements. 
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Besides  an  initialization  subroutine,  there  are  three  types  of  subroutines  in 
program  LOOKAT — drivers,  workers,  and  utilities.  The  driver  subroutines 
are  designed  to  create  Core  Catalogs  for  the  three  shape  regions  noted  in  Sec- 
tion 8. 1.  The  worker  subroutines  each  perform  one  specific  function,  and  are 
called  by  the  driver  subroutines.  The  utility  subroutines  are  called  by  worker 
and  driver  subroutines  to  perform  very  small  standard  functions,  such  as  con- 
version of  a position  from  right  ascension/declination  form  to  G.I.  unit  vector 
form. 

8.2.1  The  Driver  Subroutines 

The  Access  Module  has  three  driver  subroutines — FETCH,  BAND,  and  SLICE. 
Subroutine  FETCH  produces  a cap  Core  Catalog  centered  at  a user-input  point- 
ing and  with  user-defined  radius  (see  Figure  8-1).  Optionally,  stars  fainter 
than  an  input  limiting  magnitude  are  excluded  from  the  Core  Catalog.  Figure  8-4 
is  a logical  flow  diagram  for  FETCH. 

Subroutine  BAND  produces  a band  Core  Catalog  of  user-specified  height  cen- 
tered around  the  path  swept  out  by  a vector  located  a given  angular  distance 
from  a given  spin  axis  (see  Figure  8-2).  Optionally,  stars  fainter  than  an  input 
limiting  magnitude  are  excluded  from  the  Core  Catalog.  If  desired,  star  longi- 
tudes are  calculated  as  defined  in  Section  8.3.7.  If  longitudes  are  calculated, 
the  output  catalog  stars  are  sorted  in  order  of  ascending  longitude.  Figure  8-5 
is  a logical  flow  diagram  for  BAND. 

Subroutine  SLICE  produces  a wedge  Core  Catalog  of  user-specified  height  and 
range  centered  around  the  path  swept  out  by  a vector  located  a given  angular 
distance  from  a given  spin  axis  (see  Figure  8-3).  Figure  8-6  is  a logical  flow 
diagram  for  SLICE. 

8.2.2  The  Worker  Subroutines 

Most  of  the  worker  subroutines  are  simple  enough  so  that  the  descriptions  given 
in  Sections  8.3  and  8.5  are  sufficient.  Subroutine  STORE,  however,  is  described 
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Figure  8-4.  Subroutine  FEiCH  Logical  Flow  (1  of  2) 
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Figure  8-4.  Subroutine  FETCH  Logical  Flow  (2  of  2) 
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Figure  S-5.  Subroutine  BAND  Logical  Flow  (1  of  2) 
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Fismre  8-5.  Subroutine  BAND  Logical  Flow  (2  of  2) 
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Figure  8-6.  Subroutine  8LICE  Logical  Flow  (1  of  4) 
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Figure  8-6.  Subroutine  SLICE  Logical  Flow  (2  of  4) 
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Figure  8-6.  Subroutine  SLiCt.  Logical  Flow  i3  of  4) 
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Figure  8-6. 


Subroutine  SLICE  Logical  Flow  (4  of  4) 
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here.  STORE  is  the  subroutine  which  stores  data  in  the  Core  Catalog.  Else- 
where in  LOOKAT,  an  array  is  computed  specifying  which  zones  may  contain 
stars  needed  in  the  Core  Catalog.  STORE  reads  each  specified  subcatalog  from 
the  direct-access  Run  Catalog.  For  each  star,  the  catalog  data  is  stored  in  the 
output  arrays  provided  that  it  lies  within  the  region  of  the  sky  to  be  covered  by 
the  Core  Catalog  and  is  brighter  than  a user-specified  magnitude.  Either  or 
both  of  these  tests  may  be  "turned  off"  by  the  user  by  setting  appropriate  flags 
in  the  driver  subroutine  calling  sequence. 

Subroutine  NODUPE  is  called  by  STORE  to  determine  if  the  star  has  already 
been  stored  in  the  output  catalog.  This  may  occur  because  zones  overlap 
50  percent  in  declination.  Because  STORE  processes  zones  starting  with  the 
northernmost  and  working  southwards,  only  stars  in  the  northern  half  of  a zone 
can  possibly  be  duplicates.  NODUPE  first  determines  if  a star  is  in  the  north- 
ern half  of  its  zone.  If  it  is,  the  star  number  is  checked  against  those  of  stars 
already  in  the  Core  Catalog.  If  this  star  is  not  a duplicate,  the  Core  Catalog 
array  index  is  incremented  by  one,  and  data  from  the  next  star  is  stored.  If 
the  star  is  a duplicate,  the  index  is  not  incremented  so  that  the  next  star's  data 
overwrites  it. 

STORE  returns  the  Core  Catalog  and  a parameter  giving  the  number  of  valid 
stars  in  the  catalog. 

8.2.3  Utility  Subroutines 

The  utility  subroutines  are  limited  in  scope  and  the  descriptions  given  in  Sec- 
tions 8.3  and  8.4  are  sufficient. 

8.2.4  Initialization  Subroutine 

Subroutine  INITSK  is  used  to  read  the  first  eight  Run  Catalog  records  which  con- 
tain data  describing  the  Run  Catalog  structure  (Section  6.  6. 2. 1.  3).  I:  must  be 
executed  before  calls  to  any  of  the  driver  subroutines,  FETCH,  BAND,  or 
SLICE.  Figure  8-7  is  a logical  flow  diagram  for  INITSK. 


8-15 


original  page  « 


Figure  8-7.  Subroutine  INITSK  Logical  Flow 
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8.3  MATHE3VIATICAL  AND  LOGICAL  TECHNIQUES 


8.3.1  Determining  the  Zone  Number  Corresponding  to  a Pointing 

The  LOOKAT  subroutines  determine  which  Run  Catalog  zones  must  be  read  by 
computing  an  array  of  pointings,  representing  the  path  taken  by  a sensor  optical 
axis  during  some  interval  of  time  (see  Section  8.3.4).  Given  the  right  ascension 
and  declination  of  one  of  these  pointings,  subroutine  ZONES  determines  which 
two  subcatalogs  are  required  using  the  equations  presented  in  Section  7.3.2. 

Two  subcatalogs  adjacent  in  right  ascension  are  required  because,  in  general, 
the  zone's  right  ascension  width  is  only  half  the  arc  distance  of  its  declination 
height.  This  technique  was  used  to  provide  the  required  50-percent  zone  overlap 
in  declination.  LOOKAT  subroutines,  however,  assume  the  zones  are  "square.” 

8.3.2  Conversion  Between  Right  Ascension,  Declination,  and  Geocentric  Inertial 
Coordinates 

Subroutine  GITOAD  converts  a G.I.  unit  vector  to  right  ascension  and  declina- 
tion. Subroutine  ADTOGI  computes  the  reverse.  The  equations  used  were  given 
in  Section  6. 3. 1. 

8.3.3  Determination  of  Whether  a Star  Is  Within  the  Field  of  View 
8. 3,  3. 1 Subroutine  FETCH 

Given  a single  optical  axis  pointing , as  with  subroutine  FETCH,  a star  is  within 
a circular  field  of  view7  centered  at  that  point  provided  that 

®GI  ' °GI  2 008  r <8-17 

star  unit  vector  in  G.I.  coordinates 
optical  axis  unit  vector  in  G.I.  coordinates 
half-cone  angle  of  the  field  of  view 


where  S_T  = 

Ui 

%r 

r = 
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8 . 3 . 3 . 2 Subroutine  BAND 

For  subroutine  BAND,  a star  is  within  the  field  of  view  if  it  is  within  the  speci- 
fied distance  from  any  point  on  the  patch  swept  out  by  the  optical  axis  during  one 
rotation  about  the  spin  axis.  This  occurs  if 


C.  SS 


GI  GI 


£ C 


B 


(8-2) 


where  C = cos  (min(0  - r,  130°)) 

A 

C = cosCma x(8  - r,  0 )) 

JD 

A = spin  axis  unit  vector  in  G.I.  coordinates 

(jrl 

8=  angle  between  the  spin  axis  and  the  optical  axis  of  the  sensor 
(coelevation  angle) 

8. 3. 3. 3 Subroutine  SLICE 

For  subroutine  SLICE,  a star  is  within  the  field  of  view  if  it  passes  the  test  of 
Equation  (8-2)  and  if 


L £ L ^ L (module  360°)  (8-3) 

min  o max 

where  L is  the  star  longitude  (see  Section  8. 3. 7),  and  L . and  L are 
o ~e>  \ rm.n  max 

the  minimum  and  maximum  permitted  longitudes  as  described  in  Section  8.3.6. 
8.3.4  Calculation  of  the  Optical  Axis  Path 

For  a spinning  spacecraft,  a sensor  optical  axis  sweeps  out  a circle  on  the 
celestial  sphere  during  one  spacecraft  rotation.  Subroutines  BAND  and  SLICE 
specify  the  zones  that  must  be  read  to  generate  the  appropriate  Core  Catalog  by 
first  calculating  this  optical  axis  (pointing)  at  discrete  intervals;  the  zones  re- 
quired are  then  determined  for  e:.oh  pointing.  If  the  distance  between  computed 
pointings  is  small  compared  to  the  zone  size,  no  zones  will  be  missed  by  using 
this  procedure.  Appendix  F discusses  the  sizing  of  the  discrete  steps. 
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The  required  optical  axis  path  is  calculated  using  the  equation  presented  in 
Section  7.3. 1.  Additional  paths  parallel  to  the  optical  axis  path  are  computed 
whenever  the  sum  of  the  field-of-view  size  and  the  anticipated  spin  axis  motion/ 
uncertainty  is  too  large  relative  to  the  Run  Catalog  zone  size.  Failure  to  do  so 
would  lead  to  some  zones  being  "skipped  over"  and  thus  an  incomplete  Core 
Catalog.  Figure  8-8  shows  the  various  sweeps  necessary  to  cover  a specified 
region  of  the  sky.  The  variables  defined  below  are  also  shown  on  this  figure. 

If  F is  the  radius  of  a circle  circumscribed  about  the  field  of  view;  £ is  the 
maximum  angular  distance  the  spin  axis  is  allowed  to  move  away  from  the  axis 
used  to  create  the  Core  Catalog  before  a new  Core  Catalog  must  be  generated; 
and  T is  the  maximum  arc  distance  along  a great  circle  between  two  consec- 
utive computed  optical  axis  points , the  additional  sweeps  are  made  at 

0=0,  9=  2o  , . . . , 8 = no  , 0 ± ib  (8-4) 

where  8 is  the  nominal  coelevation  angle, 

W 

<P=~2~T  (8-5) 


where  W = zone  height, 


ib 


= F 


and  n is  an  integer  s 1 chosen  such  that 


0. 0 ^ if>  - np  £ o 


*8-6) 


(8-7) 
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The  additional  sweeps  specified  in  Equation  (S-4)  are  made  for  band  and  wedge 
Core  Catalogs  whenever 


F + e + t > W/4 


(8-8) 


For  cap  Core  Catalogs  where 


F > W/4 


(8-9) 


a similar  technique  is  used  with 


0 = 0 

r = 1.0  degree  (8-10) 

C = 0 

Appendix  F contains  a mathematical  proof  that  this  procedure  specifies  all  zones 
required  to  ensure  a complete  Core  Catalog.  The  derivations  of  Equations  (8-5) 
and  (8-6),  which  serve  to  define  <5  and  4>  , are  also  presented  in  Appendix  F. 

8.3.5  Calculation  of  a Segment  of  the  Optical  Axis  Path 

If,  during  the  interval  of  analysis,  the  spacecraft  rotates  less  than  one  complete 
rotation,  the  optical  axis  path  sweeps  out  only  a segment  of  the  band  described 
in  Section  8.3.4.  Subroutine  SLICE  takes  the  array  of  camera  optical  axis 
pointings  specified  m Section  S.3.4  and  selects  those  within  a given  number  of 
degrees  of  a given  '’central”  optical  axis  pointing. 

Three  optical  axis  sweeps  are  processed  at  once.  If  there  are  a total  of  N 
optical  axis  pointings  generated,  the  first  N’  = N f3  of  them  correspond  to 
one  sweep,  the  next  third  to  another  sweep,  and  the  final  third  to  tet  another 
sweep.  Referring  to  the  first  N'  points  in  the  optical  axis  array,  a segment  of 
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the  band  R degrees  wide  requires  that  I points  on  either  side  of  the  central 

R 

pointing  be  selected,  where 


I 


R 


1 


0.  5 R 
360/N’ 


(8-11) 


where  ( ) means  the  greatest  integer  less  than  or  equal  to  the  expression  and 
R is  the  sum  of  the  desired  width  of  the  wedge  plus  twice  the  FOV  radius  and 
error  allow'ance. 

The  central  optical  axis  pointing  will  not,  in  general,  be  one  of  the  points  in 
the  camera  optical  axis  array.  Therefore,  we  define  the  central  optical  axis 
pointing  as  that  value  . O*  » such  that 


f = 


O* 


is  a maximum,  where 

6 = central  optical  axis  pointing  input  to  the  subroutine 

The  pointings  to  be  selected,  therefore,  are  I pointings  on  either  side  of 
u*  , plus  the  corresponding  pointings  in  the  second  and  third  N1  points. 

8.3.6  Calculation  of  the  Midpoint  of  the  Optical  Axis  Path 

Subroutine  SEGMNT  requires  that  the  central  pointing  of  the  optical  axis  path  be 

specified.  Sometimes  it  is  more  convenient  to  specify  the  starting  optical  axis 

point,  6 , and  the  range,  R . Subroutine  MIDWAY  calculates  the  central 

start 

pointing, 


6 = (O  , O ,0  , 

MID  MID,x  MID , y MID,zJ 


(8-12) 
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C>  = C sin  0 + A cos  0 
MID,x  x x 


O, __  *C  sin  0 + A cos  0 

MLD,y  y y 


0,„„  - C sin  0 + A cos  0 

MID , z z z 


(8-13) 


/ -D  V / R 

C =B  cos  — - (A  B - A B ) sin 
x x 12/  y z z y 


C =B  cos  l~]- (A  B - A B ) sin(-~) 
y y \ 2 / v z x x z'  \ 2 / 


C = B cos  I • W (A  B - A B ) sinf  R 
z z \.  2 / ' x y y x 


(8-14) 


B = 
x 


°START,x  " Ax  <A'  °START) 

! B I 


B _0START,y-Av^gSTART) 
v jB; 

/N  /X 

„ _ °START,z  ~ Az  (A  °START) 

Bz  3: 


(8-15) 


9 9 9 


1/2 


where  JB|  = (B-  +■  B_  + B~)  is  determined  from  the  numerator  portion  of 
. x y z 

Equation  (8-15)  before  normalization 


A = (A  , A , A ) = spin  axis 
x y z 

R = the  angle  of  rotation  about  the  spin  axis  during  the  interval 
6 = coelevation  angle  between  the  spin  and  optical  axes 
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8.3.7  Calculation  of  Star  Longitudes 

The  longitude  of  a star  is  defined  as  the  angle  made  by  the  projection  of  the 
star  unit  vector  onto  the  spacecraft  equatorial  plane,  and  measured  from  a 
reference  axis.  The  reference  axis  is  defined  as  the  intersection  of  the  space- 
craft equatorial  plane  with  the  plane  containing  the  spacecraft  spin  axis  and  the 
vector  in  the  direction  of  the  vernal  equinox. 

The  longitude  is  given  by 


L = tan  (Xg/x^ 


(8-16) 


where 


x2  = S.  P 

/N 

Xx  = S • P'  . 

P = (A  XV)/|A  x V | 
P»  = (P  x A)/|P  x a! 


(8-17) 


(8-18) 


and  where  L = star  longitude 

s\ 

S = star  unit  vector  in  G.I.  coordinates 

A = spin  axis  unit  vector  in  G.I.  coordinates 

V = vernal  equinox  vector  in  G.I.  coordinates  = (1,  0,  0) 

A singularity  in  the  longitude  equations  occurs  when  the  spin  axis  is  parallel  to 

the  vernal  equinox  vector.  This  problem  has  been  avoided  by  a small  offset  in 

_2 

the  spin  axis.  Whenever  the  spin  axis  is  closer  than  10  degrees  from  the  plus 

(respectively,  minus)  vernal  equinox,  the  spin  axis  declination  used  to  compute 
-2  -2 

longitude  is  -10  (respectively,  +10  ) degrees  for  the  parallel  (respectively, 

antiparallel)  case. 
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8.4  BASELINE  DIAGRAM  AND  UNIT  DESCRIPTIONS 

8.4.1  Baseline  Diagram 

Figure  8-9  is  a baseline  diagram  for  the  Access  Module  of  program  LOOKAT. 

8.4.2  Unit  Descriptions 

A unit  description  of  each  subroutine  of  the  Access  Module  of  program  LOOKAT 
is  presented  in  Sections  S.4.2.1  through  8.4.2.19.  An  explanation  of  the  tabular 
formats  used  in  these  subsections  is  given  in  Section  2.4.1.  Appendix  G is  a 
FORTRAN  compiler  listing  of  LOOKAT. 

The  following  is  an  index  to  all  program  LOOKAT  Access  Module  subroutines 
and  functions . 
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8.  4.  2. 1 Subroutine  ADTOGI 

DESCRIPTION:  Subroutine  ADTOGI  converts  a vector  in  right  ascension  and 
declination  to  a G.I.  unit  vector. 

CALLING  SEQUENCE:  Subroutine  ADTOGI  (ALPHA,  DELTA,  X,  Y,  Z) 
COMMON  AREAS  REFERENCED:  None  . 

EXTERNAL  REFERENCES:  None 

CALLED  BY:  FETCH,  LONG,  MIDWAY,  OPCONV,  SLICE,  STORE 
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ADTOGI 
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BAND 


8.  4.’2. 2 Subroutine  BAND 

DESCRIPTION:  Subroutine  BAND  produces  a catalog  in  ISTDAT  and  FSTDAT, 
given  a spin  axis  and  coelevation. 

CALLING  SEQUENCE:  Subroutine  BAND  (ITYPE,  A,  B,  C,  COELEV,  TOLER, 

SLOP,  IFMAG,  FMAGLM,  IFFOV,  FOV 
IFLONG,  ISTDAT,  FSTDAT,  STLONG, 
NDIM1,  NDIM2,  NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  OPAXIS,  OPGI,  PARAMS,  POINT 
EXTERNAL  REFERENCES:  GITOAD,  LONG,  PATH, SORTLG,  SPINAX,  STORE 
CALLED  BY:  User  program 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
error  message  printed  output. 

ERROR  MESSAGES: 

'BAND.  . .ERROR  OCCURRED  IN  SUBROUTINE  xxxxxxxx. . . PROGRAM 
RETURNS. 1 This  is  accompanied  by  a message  from  subroutine  (xxxxxxxx). 
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8 . 4 . 2 . 3 Subroutine  DLAG 

DESCRIPTION:  Subroutine  DIAG  prints  the  leading  diagnostic  message,  and 
returns  the  level  of  diagnostic  output  flag  (IFDLAG)  and  the  number  of  the 
diagnostic  output  file  (EDFL). 

CALLING  SEQUENCE:  Subroutine  DIAG  (TITLE, IFDLAG, ID FL) 

COMMON  AREAS  REFERENCED:  FILES 
EXTERNAL  REFERENCES:  None 

CALLED  BY:  INITSK,  LONG,  MIDWAY,  O PC  ON  V,  PATH,  SEGMNT,  SORTLG, 
SPINAX,  STORE,  ZONES 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  IDFL  is 
printed  diagnostic  output. 
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DIAG 


S-35 


DIAG2 


OKiGvNAL  IrV'.aS  f3 

OF 'POOR  QUALITY 


8. 4. 2. 4 Subroutine  DLAG2 

DESCRIPTION:  Subroutine  DL4.G2  prints  the  trailing  diagnostic  message. 
CALLING  SEQUENCE:  SUBROUTINE  DIAG2  (TITLE) 

COMMON  AREAS  REFERENCED:  FILES 
EXTERNAL  REFERENCES:  NONE 

CALLED  BY:  INITSK,  LONG,  MIDWAY,  OPCONV,  PATH,  SEGMNT,  SORTLG, 
SPINAX,  STORE,  ZONES 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  IDFL  is 
printed  diagnostic  output. 
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8.  4.  2.  5 Subroutine  FETCH 

DESCRIPTION:  Subroutine  FETCH  is  a driver  routine  that  produces  a ''cap'' 
Core  Catalog  for  a given  optical  axis  pointing. 

CALLING  SEQUENCE:  Subroutine  FETCH(ITYPE,  A,  B,  C,  IFMAG,  FMAGLM, 

IFFOV,  FOV,  ISTDAT,  FSTDAT, 
NDIM1,  NDIM2,  NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  PARAMS,  POINT,  OPAXIS 

EXTERNAL  REFERENCES:  ADTOGI,  GITOAD,  PATH,  SPINAX,  STORE,  ZONES 

CALLED  BY:  User  program 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  sets  reference  number  16  is 
error  message  output. 

ERROR  MESSAGES: 

'FETCH  . . . ZONE  REQUESTED  NOT  AVAILABLE  . . . PROGRAM  RETURNS. ' 
The  zone  requested  by  FETCH  was  not  present  on  the  input  Run  Catalog. 

'FETCH  . . . ERROR  OCCURRED  IN  SUBROUTINE  STORE  . . . PROGRAM 
RETURNS' — Some  fatal  error  occurred  in  subroutine  STORE.  This  is  accom- 
panied by  a specific  error  message  from  STORE. 
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8.  4.  2.  6 Subroutine  GITOAD 

DESCRIPTION:  Subroutine  GITOAD  converts  a geocentric  inertial  unit  vector 
(X,Y,Z)  to  right  ascension  and  declination. 

CALLING  SEQUENCE:  Subroutine  GITOAD(X,Y,  Z,  ALPHA,  DELTA) 
COMMON  AREAS  REFERENCED:  None 
EXTERNAL  REFERENCES:  None 
CALLED  BY:  BAND,  FETCH,  MIDWAY,  SLICE 
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8. 4. 2. 7 Subroutine  INITSK 

DESCRIPTION:  Subroutine  INITSK  initializes  various  variables  in  COMMON 
/PARAMS/  by  reading  the  first  eight  records  of  INFILE. 

CALLING  SEQUENCE:  SUBROUTINE  INITSK  (no  calling  sequence) 

COMMON  AREAS  REFERENCED:  FERMSG,  FILES,  PARAMS,  POINT 

EXTERNAL  REFERENCES:  DIAG,  DIAG2,  DREAD 

CALLED  BY:  User  program 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  INFILE 
is  a direct-access  Run  Catalog.  FORTRAN  data  set  reference  number  IDFL  is 
printed  diagnostic  output.  ' 

ERROR  MESSAGES: 

'INITSK  . . . READ  ERROR  ON  RUN  CATALOG  FILE  . . . PROGRAM  STOPS. 
DAIO  ERROR  MESSAGE  HELD  IS 

ZZZZZZZZ  IimiAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 
AAAAAZZZZZZZZ  ZZZZZZZZ  ZZZZZZZZ  ZZZZZZZZ' 

The  Z,  I,  and  A fields  indicated  are  hexadecimal,  integer,  and  alphameric  in- 
formation, respectively,  from  the  DAIO  error  return  fields.  The  user  must 
determine  what  error  occurred  by  consulting  "Data  Management  Techniques” 
in  Reference  35  and  take  appropriate  action. 
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8. 4.  2. 8 Subroutine  LONG 

DESCRIPTION:  Subroutine  LONG  calculates  longitudes  of  stars  in  the  ISTDAT 
and  FSTDAT  arrays.  The  longitudes,  relative  to  a great  circle  intersecting 
the  vernal  equinox  and  the  spin  axis,  are  stored  in  STLONG. 

CALLING  SEQUENCE:  SUBROUTINE  LONG  (SPINAL,  SPINDL,  COELEV, 

ISTDAT,  FSTDAT,  STLONG,  NDIM1, 
NDIM2,  NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES 
EXTERNAL  REFERENCES:  ADTOGI, DIAG, DIAG2 
CALLED  BY:  BAND,  SLICE 


INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  IDFL  is 
printed  diagnostic  output. 
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8.  4.  2.  9 Subroutine  MIDWAY 

DESCRIPTION:  Subroutine  MIDWAY  calculates  the  middle  of  a range  of  op- 
tical axis  pointings,  given  the  initial  optical  axis  pointing,  the  spin  axis  pointing, 
and  the  range  over  which  the  spacecraft  spins. 

CALLING  SEQUENCE:  SUBROUTINE  MIDWAY  (SPINAL,  SPINDL,  COELEV, 

OAALP,  OADEL,  RANGE, 
ALPM1D,  DELMID.XMID, 

YMID,  Z MID) 

COMMON  AREAS  REFERENCED:  FILES 

EXTERNAL  REFERENCES:  ADTOGI, DIAG, DIAG2 , GITOAD,  VPHSKY 
CALLED  BY:  SLICE 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  EDFL  is 
diagnostic  output. 
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8.4.2.10  Subroutine  NODUPE 

DESCRIPTION:  Subroutine  NODUPE  ensures  that  no  duplicate  stars  are  loaded 
into  the  ISTDAT  and  FSTDAT  arrays.  It  increments  the  place-keeping  index, 
IPLACE,  for  these  arrays  only  if  the  current  candidate  star  is  not  already  in 
the  catalog,  and  if  it  is  brighter  than  the  specified  magnitude  limit  if  there  is 
one. 

CALLING  SEQUENCE:  SUBROUTINE  NODUPE  (IPLACE,  NMAX,  IROWHR,  I, 

ZLIM,  IERRA,  IERRB,  IF  MAG, 
FMAGLM,  ISTDAT,  FSTDAT, 
NDIM1,  NDIM2,  NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  PARAMS,  POINT 
EXTERNAL  REFERENCES:  None 
CALLED  BY:  STORE 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
printed  error  message  output. 

ERROR  MESSAGES: 

'NODUPE  ...  OVERFLOW  IN  THE  ISTDAT  AND  FSTDAT  ARRAYS  AT  STAR 
NUMBER  xxxxxxxx  IN  ZONE  NUMBER  yyyyy  . . . SUBROUTINE  RETURNS  TO 
DRIVER  SUBROUTINE  THROUGH  SUBROUTINE  STORE.' 
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8.4.2.11  Subroutine  OPCONV 

DESCRIPTION;.  Subroutine  OPCONV  converts  the  CAMALP,  C AMD  EL  arrays 
into  geocentric  inertial  coordinates  and  stores  the  results  in  CAMX,  CAMY  and 
CAMZ. 

CALLING  SEQUENCE:  Subroutine  OPCONV  (no  calling  sequence) 

COMMON  AREAS  REFERENCED:  FILES,  OPAXIS,  OPGI 
EXTERNAL  REFERENCES:  ADTOGI, DIAG, DIAG2* 

CALLED  BY:  SLICE 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  EDFL  is 
for  diagnostic  output. 
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8.  4.  2. 12  Subroutine  PATH 

DESCRIPTION:  Subroutine  PATH  determines  which  zones  are  required,  given 
the  path  of  the  optical  axis  (CAMALP,  CAMDEL). 

CALLING  SEQUENCE:  SUBROUTINE  PATH  (IFZERO) 

COMMON  AREAS  REFERENCED:  FILES,  OPAXIS,  PARAMS,  POINT 

EXTERNAL  REFERENCES:  DIAG,  DIAG2,  ZONES 

CALLED  BY:  BAND,  FETCH,  SLICE 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  IDFL 
is  diagnostic  output. 
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8. 4.  2. 13  Subroutine  SEGMNT 

DESCRIPTION;  Subroutine  SEGMNT  alters  the  CAMALP,  CAMDEL  arrays  so 
that  they  contain  only  those  points  within  RANGE/2  degrees  from  the  point 
(ALP MID,  DELMID). 

CALLING  SEQUENCE:  Subroutine  SEGMNT (ALPM3D , DELMID , XMID , YMID , 

Z MID,  RANGE) 

COMMON  AREAS  REFERENCED:  FILES,  OPAXIS,  OPGI 
EXTERNAL  REFERENCES:  DIAG, DLAG2 
CALLED  BY:  SLICE 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  IDFL  is 
diagnostic  printed  output.  FORTRAN  data  set  reference  number  16  is  error 
message  printed  output. 

ERROR  MESSAGES: 

’SEGMNT  . . . SEGMNT  WAS  CALLED  BEFORE  OPCONV  . . . EXECUTION 
CONTINUES’— The  CAMX,  CAMY,  and  CAMZ  arrays  may  not  have  been  cal- 
culated; the  resultant  catalog  may  be  incorrect.  This  error  occurs  only  when 
SEGMNT  is  called  by  the  user  independently  of  the  LOOKAT  driver  subroutines. 
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8.4.2.14  Subroutine  SLICE 

DESCRIPTION:  Subroutine  SLICE  produces  a catalog  in  ISTDAT  and  FSTDAT, 
given  a spin  axis,  coelevation  angle,  starting  or  central  optical  axis  and  range. 
The  catalog  represents  a portion  of  a spin-band  catalog. 

CALLING  SEQUENCE:  SUBROUTINE  SLICE  (ITYPE , A,  B,  C,  COELEV,  TOLER, 

SLOP,  IOABEG,  IOATYP,  OA,  OB, 
OC,  RANGE,  IF  MAG,  FMAGLM, 
IFFOV,  FOV,  IFLONG,  ISTDAT, 
FSTDAT,  STLONG,  NDIM1,  NDIM2, 
NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  OPAXIS,  OPGI,  PARAMS,  POINT 

EXTERNAL  REFERENCES:  ADTOGI,  GITOAD,  LONG,  MIDWAY,  OPCONV, 
PATH,  SEGMNT,  SORTLG,  SPIN  AX,  STORE 

CALLED  BY’:  User  program 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is  error 
message  printed  output. 

ERROR  MESSAGES: 

'SLICE  . . . ERROR  OCCURRED  IN  SUBROUTINE  xxxxxxxx  . . . PROGRAM 
STOPS' — This  is  accompanied  by  message  from  subroutine  (xxxxxxxx). 
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8.4.2.15  Subroutine  SORTLG  yuMU,r 

DESCRIPTION:  Subroutine  SORTLG  sorts  the  stars  in  the  ISTDAT,  FSTDAT, 
and  STLONG  arrays  in  order  of  increasing  longitude  (ST LONG). 

CALLING  SEQUENCE:  SUBROUTINE  SORTLG  (ISTDAT,  FSTDAT,  STLONG, 

NDIM1,  NDIM2,  NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  PARAMS 

EXTERNAL  REFERENCES:  DIAG,DIAG2 

CALLED  BY:  BAND,  SLICE 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  IDFL 
is  printed  diagnostic  output. 
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8.  4.  2. 16  Subroutine  SPINAX 

DESCRIPTION:  Subroutine  SPINAX  calculates  the  path  taken  by  the  optical 
axis  of  a camera  at  discrete  (TOLER)  intervals  over  one  rotation. 

CALLING  SEQUENCE:  SUBROUTINE  SPINAX  (SPINAL,  SPINDL,  COELEV, 

TOLER,  SLOP,  IERRA,  IERRB) 

COMMON  AREAS  REFERENCED:  FILES,  OPAXIS,  PARAMS 

EXTERNAL  REFERENCES:  DLYG, DLA.G2 

CALLED  BY:  BAND,  FETCH,  SLICE 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
printed  error  message  output.  FORTRAN  data  set  reference  number  IDFL  is 
printed  diagnostic  output. 

ERROR  MESSAGES: 

'SPINAX  ...  OVERFLOW  OF  THE  CAMALP  AND  CAMDEL  ARRAYS  ...  SUB- 
ROUTINE RETURNS. 1 — More  than  1100  optical  axis  printings  were  generated. 
Increase  the  size  of  TOLER. 
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8.4.2.17  Subroutine  STORE 

DESCRIPTION:  Subroutine  STORE  creates  a catalog  in  the  ISTDAT  and 
FSTDAT  arrays  covering  the  zones  requested  in  the  array  IZONES  using  input 
file  INFILE.  Redundant  stars  are  eliminated. 

CALLING  SEQUENCE:  SUBROUTINE  STORE  (IERRA,  IERRB,  IFMAG, 

FMAGLM,  FOV,  SLOP,  IFFOV, 
SPINAL,  SPINDL,  COE  LEV, 
ISTDAT , FSTDAT , NDIM1 , 

NDIM2,  NUMCAT) 

COMMON  AREAS  REFERENCED:  FERMSG,  FILES,  PARAMS,  POINT 
EXTERNAL  REFERENCES:  ADTOGI,  DIAG,  DIAG2,  DREAD,  NODUPE 
CALLED  BY:  BAND,  FETCH,  SLICE 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
printed  error  message  output.  FORTRAN  data  set  reference  number  INFILE 
is  a direct-access  Run  Catalog.  FORTRAN  data  set  reference  number  IDFL  is 
printed  diagnostic  output. 

ERROR  MESSAGES: 

’STORE  . . . ZONE  xxxx  NOT  IN  INPUT  CATALOG  . . . SUBROUTINE 
RETURNS. ' 

'STORE  . . . READ  ERROR  ON  RUN  CATALOG  FILE  . . . PROGRAM  RETURNS.  ’ 
DAIO  ERROR  MESSAGE  FIELD  IS 

ZZZZZZZZ  IIIIII  AAAAAAAA  AAAAAAAA  AAAAAAAA 
AAAAAAAA  AAAAAAAA  AAAAAAAA  AAAAAAAA  AAAAAAAA 
AAAAAAAA  AAAAAAAA  ZZZZZZZZ  ZZZZZZZZ  ZZZZZZZZ 
ZZZZZZZZ’ 

The  Z,  I,  and  A fields  indicated  are  hexadecimal,  integer  and  alphameric  in- 
formation, respectively,  from  the  DAIO  error  return  fields.  The  user  must 
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determine  what  error  occurred  by  consulting  Reference  35  under  "Data  Manage- 
ment Techniques"  and  take  appropriate  action. 
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8. 4.  2. 18  Subroutine  VPHSKY 


VPHSKY 


DESCRIPTION:  Subroutine  VPHSKY  computes  the  unit  vector  corresponding  to 
a given  rotation  angle  and  a given  angular  separation. 

CALLING  SEQUENCE:  SUBROUTINE  VPHSKY  (A,  B,  PHI,  COSCON, SINCON,  C) 
COMMON  AREAS  REFERENCED:  None 
EXTERNAL  REFERENCES:  None 
CALLED  BY:  MIDWAY 
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8.4.2.19  Subroutine  ZONES  . 

DESCRIPTION:  Subroutine  ZONES  calculates  the  zone  numbers  (LZA.LZB) 
required  for  a given  pointing  (OAALP, OADEL). 

CALLING  SEQUENCE:  SUBROUTINE  ZONES(OAALP,  OADEL,  LZA,  LZB) 
COMMON  AREAS  REFERENCED:  FILES,  PARA  MS 
EXTERNAL  REFERENCES:  DIAG, DIAG2 
CALLED  BY:  BAND,  FETCH,  PATH 

INPUT /'OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  EDFL  is 
printed  diagnostic  output. 
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8.  5 COMMON  AREA  DESCRIPTIONS 
8.5.1  COMMON  /FERMSG/ 

DESCRIPTION:  COMMON  /FERMSG/  contains  the  DAIO  error  message  fields. 
FORM:  COMMON  /FERMSG/  IMES(26) 

REFERENCED  BY:  INTTSK,  STORE 
DEFINITION  OF  VAR  TABLES: 

Name  Type  Description 

IMES(26)  4-byte  hexadecimal,  DAIO  error  message  fields — see 

integer  and  alpha-  Reference  35 

meric 
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8.5.2  COMMON  /FILES/ 

DESCRIPTION:  COMMON  /FILES/  contains  parameters  defining  program  files. 

FORM:  COMMON  /FILES/15, 16,  INFILE , INREC,  IFDG,  EDFL 

REFERENCED  BY:  BAND,  DIAG,  DIAG2,  FETCH,  INITSK,  LONG,  MIDWAY, 
NODUPE,  OPCONV,  PATH,  SEGMNT,  SLICE,  SORTLG,  SPINAX,  STORE,  ZONES 


DEFINITION  OF  VARIABLES: 


Name 


Type 


Description 


15 

1*4 

16 

1*4 

IN  FILE 

1*4 

INREC 

1*4 

IFDG 

1*4 

EDFL 

1*4 

Card  input  file  number 

Error  message  output  file  number 

Direct-access  input  Run  Catalog  file  number 

Associated  variable  for  INFILE 

Diagnostic  control  flag  - 
= 0,  no  diagnostics 

= 1,2, 3, 4,  5,  successively  more  diagnostics 
printed 

Diagnostic  output  file  number 
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8.5.3  COMMON  /OPAXIS/ 

DESCRIPTION:  COMMON  /OPAXIS/  contains  the  optical  axis  pointing  calculated 
for  a spinning  spacecraft. 

FORM:  COMMON  /OPAXIS/  CAMALP(llOO),  CAMDEL(llOO),  NCAMPT 
REFERENCED  BY:  BAND,  FETCH,  OPCONV,  PATH,  SEGMNT,  SLICE,  SPIN  AX 
DEFINITION  OF  VARIABLES: 

Name  Type  Description 

CAMALP(llOO))  R*4  Right  ascension  and  declination  of 

CAMDEL(llOO))  the  discrete  optical  axis  pointings 

calculated  for  a spinning  spacecraft 
(degrees) 

NCAMPT  1*4  Number  of  valid  points  in  the  CAMALP 

and  C AMD  EL  arrays 
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8.5.4  COMMON  /OPGI/ 

DESCRIPTION:  OPGI  contains  the  geocentric  inertial  unit  vectors  corresponding 
to  the  optical  axis  pointing  in  COMMON  /OPAXtS/. 

FORM:  COMMON  /OPGI/  CAMX(llOO),  CAMY(llOO),  CAMZ(1100),IFOPGI 
REFERENCED  BY:  BAND,  OPCONV,  SEGMNT,  SLICE 
DEFINITION  OF  VARIABLES: 


Name 

Type 

Description 

CAMX,  CAMY, 
CAMZ 

R*4 

X,  Y,  and  Z components  of  the  optical 
axis  pointings  in  COMMON  /OPAXIS/ 

IFOPGI 

1*4 

OPCONV  call  flag  - 
= 0,  OPCONV7  has  not  been  called 

= 1,  OPCONV  has  been  called 
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8.5.5  COMMON  /PARAMS/ 

DESCRIPTION:  PARAMS  contains  control  words  and  arrays  which  define  the 
structure  of  the  Run  Catalog. 

FORM:  COMMON  /PARAMS/  NZONES,  ROWMAX(40),  ROWMIN(40),  ROWWID(40), 
NROWST(40),  NL'MROW (40) , NROWS,  NWORDS,  NPER,  W,  IZ  ROW  (2800) 

REFERENCED  BY:  BAND,  FETCH,  INITSK,  NODUPE,  PATH,  SLICE,  SORTLG, 
SPINAX,  STORE,  ZONES 

DEFINITION  OF  VARIABLES: 


Name  Type  Description 


NZONES 

1*4 

Number  of  zones 

ROW  MAX  (40) 

R*4 

Maximum  row  declination  for  the  Ith 
row  (1  s I < NROWS)  (degrees) 

ROWMIN(40) 

R*4 

Minimum  row  declination  for  the  Ith 
row  (lsis  NROWS)  (degrees) 

ROWWID(40) 

R*4 

Right  ascension  width  of  the  zones  in 
the  Ith  row  (1  s I s NROWS)  (degrees) 

NROWS  T (40) 

1*4 

Number  of  the  first  zone  in  the  Ith 
row  (1  £ I £ NROWS) 

NUMROW(40) 

1*4 

Total  number  of  zones  in  the  Ith 
row  (lsis  NROWS) 

NROWS 

1*4 

Number  of  rows 

NWORDS 

1*4 

Number  of  words  of  data  per  star 

NPER 

1*4 

Number  of  dita  segments  in  one 
logical  record  (see  Section  6. 6. 2. 1.4) 

W 

1*4 

Declination  height  of  the  rows  (de- 
grees) 

IZ  ROW  (2  3 00) 

1*4 

Row  number  for  the  ith  zone 
'lsis  NZONES) 
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8.5.6  COMMON  /POINT/ 

DESCRIPTION:  POINT  contains  arrays  describing  which  zones  are  available  on 
the  input  Run  Catalog  and  which  are  requested  on  the  output  catalog. 

FORM:  COMMON  /POINT /IZ ONES (2800),  IPOINT(2800) 

REFERENCED  BY:  BAND,  FETCH,  INITSK,  NODUPE,  PATH,  SLICE,  STORE 

DEFINITION  OF  VARIABLES: 

Name  ' Type  Description 

IZ  ONES (28 00)  1*4  Zone  output  flag - 

IZONES(I)  = 0,  do  not  output  data 
from  zone  I 

= 1,  output  data  from  zone 
zone  I 

Valid  for  I = 1,  . . . , number  of  zones 

IPOINT'2800)  1*4  IPOINT(I)  = record  number  of  the 

first  logical  record  in  the  Run 
Catalog  for  Zone  I.  If  IPOINT(I) 
is  negative,  Zone  I is  not  present. 
Valid  for  1 = 1,  . . . , number  of 
zones 
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8.6  USER'S  MANUAL 

This  section  will  permit  the  user  to  formulate  code  to  generate  Core  Catalogs 
using  Access  Module  driver  subroutines. 

8.6.1  Using  Existing  Driver  Subroutines 

The  Access  Module  contains  three  driver  subroutines  which  may  be  called  by 
user  programs  to  create  Core  Catalogs. 

The  three  driver  subroutines  are  FETCH,  BAND,  and  SLICE.  Each  is  described 
in  detail  in  Section  8,6.2.  The  following  steps  must  be  taken  to  use  any  Access 
Module  driver  subroutine: 

• LOOKAT  uses  dynamic  dimensioning  for  the  Core  Catalog  output 
arrays.  In  the  main  routine,  dimension  statements  must  be  hard 
coded  for  the  ISTDAT,  FSTDAT,  and  STLONG  arrays.  ISTDAT 
and  STLONG  must  be  dimensioned  to  the  value  of  NDIM1  used  in 
the  driver  subroutine  calling  sequence.  FSTDAT  must  be  doubly 
dimensioned;  the  first  dimension  is  NDIM1  and  the  second  is 
NDIM2,  as  used  in  the  driver  subroutine  calling  sequence. 

NDIM1  is  the  maximum  number  of  stars  anticipated  in  the  Core 
Catalog;  NDIM2  is  the  number  of  floating  point  words  of  data  per 
star  to  be  output  in  the  Core  Catalog. 

• The  following  parameters  in  COMMON  /FILES/  must  be  set:  16, 
INFILE,  and  IFDG.  If  IFDG  / 0,  IDFL  must  also  be  set.  Default 
values  are  not  provided  by  LOOKAT.  The  remaining  parameters  — 

15  and  INREC — are  not  used  by  the  Access  Module.  Section  S.  5.2 
defines  these  parameters.  It  should  be  noted  that  INFILE  must  be 

a one-  or  two-digit  positive  integer,  must  not  equal  16  or  IDFL,  and 
must  agree  with  the  JCL  DD  statement  for  the  input  Run  Catalog. 
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• Call  SUBROUTINE  INITSK  before  calls  are  made  to  any  other 
LOOKAT  subroutines.  Repeated  calls  to  INITSK  use  computer  time, 
but  do  not  otherwise  affect  performance  of  LOOKAT  subroutines. 

• Code  CALL  statements  to  the  driver  subroutines  with  all  input  calling 
sequence  variables  defined.  When  the  driver  returns  control  to 

the  user  program,  the  requested  Core  Catalog  will  exist  in  core, 
provided  no  error  conditions  described  below  are  encountered. 

8.6.2  The  Driver  Subroutines 
8.6.  2.1  Subroutine  FETCH 

FETCH  produces  a Core  Catalog  containing  all  the  stars  within  a specified  half- 
cone angle  whose  axis  is  centered  on  a user-specified  pointing.  Reference  36 
is  a convenient  small  document  describing  the  user's  interface  with  FETCH. 

8.  6.2.2  Subroutine  BAND 

BAND. produces  a Core  Catalog  containing  all  the  stars  located  in  a band  of 
user-input  width  about  the  path  taken  by  the  optical  axis  of  a spinning  sensor. 
Reference  37  is  a convenient  small  document  describing  the  user's  interface 
with  BAND. 

8.  6.  2.3  Subroutine  SLICE 

SLICE  produces  a Core  Catalog  containing  all  the  stars  in  a user-specified 
subset  of  a band  catalog,  defined  by  minimum  and  maximum  longitudes,  relative 
to  a spin  inertial  frame.  Reference  38  is  a convenient  small  document  de- 
scribing the  user  interface  with  SLICE. 

8.6.3  Input  to  the  Access  Module 

Input  to  the  Access  Module,  other  than  calling  sequence  variables,  consists  of  a 
direct-access  disk  Run  Catalog  (created  by  program  CAT)  cr  selected  Run 
Catalog  (created  by  program  SWITCH). 
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LOOKAT  has  no  NAME LISTs;  user  entry  of  data  into  the  Access  Module  is 
accomplished  by  calling  sequences  and  COMMON  blocks. 

8.6.4  Output  From  the  Access  Module 

Output  from  the  Access  Module  is  limited  to  error  messages,  diagnostic  printed 
output,  and  the  Core  Catalog. 

8. 6. 4.1  Error  Message  Output 

Program  contingencies  cause  error  message  output  on  FORTRAN  data  set  refer- 
ence number  16  (a  COMMON  /FILES/  variable).  A complete  listing  of  these 
messages,  together  with  brief  explanations  where  necessary,  is  given  below. 

'BAND  . . . ERROR  OCCURRED  IN  SUBROUTINE  xxxxxxxx  . . . PROGRAM 
RETURNS' — This  is  accompanied  by  a message  from  the  subroutine  stated. 

’FETCH  . . . ZONE  REQUESTED  NOT  AVAILABLE  . . . PROGRAM  STOPS. » 

A zone  requested  by  FETCH  was  not  present  on  the  input  Run  Catalog.  This  is 
accompanied  by  an  error  message  from  subroutine  AVAIL. 

'FETCH  . . . ERROR  OCCURRED  IN  SUBROUTINE  STORE  . . . PROGRAM 
RETURNS' — Some  fatal  error  occurred  in  subroutine  STORE.  This  is  accom- 
panied by  a specific  error  message  from  STORE. 

'INITSK  . . . READ  ERROR  ON  RUN  CATALOG  FILE  . . . PROGRAM  STOPS. 
DAIO  ERROR  MESSAGE  HELD  IS 

ZZZZZZZZ IIIIIIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 
AAAAAA.AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 
AAAAAZZZZZZZZ  ZZZZZZZZ  ZZZZZZZZ  ZZZZZZZZ' 

The  Z,  I,  and  A fields  indicated  are  hexidecimal,  integer,  and  alphameric  in- 
formation, respectively,  from  tne  DAIO  error  return  fields.  The  user  must 
determine  what  error  occurred  by  consulting  Reference  35  under  ''Data  Manage- 
ment Techniques*'  and  take  appropriate  action. 


8-85 


- ,-V 

G'i\: ^ r'\<a>^ 


^,-r  Z^r 

4-  • **<.*' 


'NODUPE  . . . OVERFLOW  IN  THE  ISTDAT  AND  FSTDAT  ARRAYS  AT  STAR 
NUMBER  xxxxxxxx  IN  ZONE  NUMBER  yyyyy  . . . SUBROUTINE  RETURNS  TO 
DRIVER  SUBROUTINE  THROUGH  SUBROUTINE  STORE.' 

'SEGMNT  . . . SEGMNT  WAS  CALLED  BEFORE  OPCONV  . . . EXECUTION 
CONTINUES' — The  CAMX,  CAMY,  and  CAMZ  arrays  may  not  have  been  cal- 
culated; the  resultant  catalog  may  be  incorrect. 

'SLICE  . . . ERROR  OCCURRED  IN  SUBROUTINE  xxxxxxxx  . . . PROGRAM 
RETURNS' — This  is  accompanied  by  a message  from  the  indicated  subroutine. 

'SPINAX  . . . OVERFLOW  OF  THE  CAMALP  AND  CAMDEL  ARRAYS  . . . SUB- 
ROUTINE RETURNS.' — More  than  1100  optical  axis  pointings  were  generated. 
Increase  the  size  of  TOLER. 

'STORE  . . . ZONE  xxxx  NOT  IN  INPUT  CATALOG  . . . SUBROUTINE  RETURNS. ' 

'STORE  . . . READ  ERROR  ON  RUN  CATALOG  FILE  . . . PROGRAM  RETURNS. 
DAIO  ERROR  MESSAGE  FIELD  IS 

ZZZZZZZZ IIIIIIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 
AAAAAZZZZZZZZ  ZZZZZZZZ  ZZZZZZZZ  ZZZZZZZZ' 

The  Z,  I,  and  A fields  indicated  are  hexidecimal,  integer,  and  alphameric  in- 
formation, respectively,  from  the  DAIO  error  return  fields.  The  user  must 
determine  what  error  occurred  by  consulting  Reference  35  under  "Data  Manage- 
ment Techniques"  and  take  appropriate  action. 

8 . 6 . 4. 2 Diagnostic  Output 

Diagnostic  output  may  be  requested  by  the  user;  it  is  written  on  FORTRAN  data 
set  reference  number  IDFL,  provided  IFDG^*  0 (both  are  COMMON  /FILES/ 
parameters).  Diagnostic  output  consists  of  trace  messages  delineating  the  entry 
and  exit  of  each  major  subroutine,  plus  selected  variables.  Values  of  IFDG  of 
1,  2,  3,  4,  and  5 produce  successively  more  output.  Level  1 produces  little 
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more  than  trace  messages.  Level  2 writes  major  input/output  variables. 

Level  3 writes  larger  input/ output  arrays  and  some  calculated  variables. 

Level  4 includes  large  calculated  arraj's,  and  level  5 includes  many  variables 
produced  inside  of  DO  loops . 

8. 6. 4. 3 Core  Catalog 

The  Core  Catalog  contains  precisely  the  same  data  as  the  input  Run  Catalog 
(see  Table  6-4). 

8.6.5  Job  Control  Language 

The  GO  step  of  any  job  using  the  Access  Module  must  contain  a DD  statement 
defining  the  star  catalog.  The  form  of  this  statement  is 

//FTxxFOOl  DD  DSN=ATTIT.  CAMERA.  SKYMAP.  DATA, DISP=SHR 

where  xx  is  replaced  by  the  file  number  assigned  to  the  Run  Catalog,  and  must 
equal  COMMON  /FILES/  parameter  INFILE. 

DD  statements  must  also  be  provided  for  files  16  and  IDFL  if  these  are  not 
directed  to  defaulted  SYSOUT  files. 

LOOKAT  subroutines  are  available  in  nonexecutable  load  module  form  and  may 
be  referenced  by  including  the  following  in  the  GO  step  JCL: 

//SYSLIB  DD  DSN=ATTIT. SKYMAP.  LOOKAT.  OBJ,  DISP=SHR 

5.6.6  Overlay  Considerations 

Various  portions  of  the  Access  Module  can  be  overlaid.  We  recommend  against 
overlay  of  COMMON  /FILES/  and  COMMON  /PARAMS/  unless  no  further  calls 
to  LOOKAT  subroutines  are  anticipated.  If  these  are  overlaid,  COMMON 
/FILES/  must  be  reset  by  the  user  program  and  COMMON  /'PARAMS/'  by  a call 
to  subroutine  INITSK.  All  subroutines  can  be  overlaid  without  harm,  but  care 
should  be  taken  to  keep  all  subroutines  within  a working  segment  (defined  as  a 
driver  and  its  attendant  structure;  see  Figure  :;-9)  in  a single  leg. 
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8.6.7  System  Resources  Needed 

LOOKAT  is  designed  to  run  on  the  IBM  S/360-95  computer  under  OS/HASP  or 
OS/MVT. 

Disk  storage  is  required  for  the  input  Run  Catalog.  The  amount  of  storage 
needed  depends  on  the  size  of  the  input  Run  Catalog  (see  Sections  6.6.5  and 
7.  6.  5). 

Storage  required  for  the  GO  step  depends  on  which  subroutines  are  to  be  used. 
Table  8-1  presents  the  size  of  each  subroutine  as  compiled  under  FORTRANH, 
option  2.  Table  8-2  presents  the  sizes  of  the  various  COMMON  blocks. 

The  total  storage  needed  is  the  sum  of  that  required  for  the  chosen  subroutines 
and  all  the  COMMON  blocks  plus  up  to  20K  bytes  for  input/output  buffers. 

8.6.8  Execution  Time  Estimates 

Because  of  the  large  variety  of  options  available  in  LOOKAT,  we  have  not 
attempted  to  estimate  execution  times.  For  a li  mi  ting  magnitude  of  7.5,  Core 
Catalogs  have  been  generated  containing  up  to  3000  stars  in  less  than  0.25  min- 
ute each  for  CPU  and  I/O  time. 
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Table  8-1.  Subroutine  Sizes  for  the  Access  Module 


SUBROUTINE  NAME 

SIZE 

/DECIMAL  8YTES) 

ADTOGI 

526 

BAND 

1758 

DIAG 

408 

DIAG2 

316 

FETCH 

1786 

GITOAD 

480 

INITSK 

4026 

LONG 

1914 

MIDWAY 

1506 

NODUPE 

932 

OPCONV 

692 

PATH 

834 

SEGMNT 

3236 

SLICE 

2952 

SORTLG 

2030 

SPINAX 

2066 

STORE 

4128 

VPHSKY 

810 

ZONES  , 

962 

8-89 
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Table  8-2.  COMMON  Block  Sizes  for  the  Access  Module 


COMMON  AREA  NAME 

SIZE 

(DECIMAL  BYTES) 

FERMSG 

104 

FILES 

24 

OPAXIS 

8804 

OPGI 

13204 

PARAMS 

12020 

POINT 

22400 
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SECTION  9 - ANALYZING  THE  RUN  CATALOG 


Statistical  analysis  of  the  Run  Catalog  is  performed  by  the  Statistics  Module  of 
program  LOOKAT.  Using  the  subroutines  of  the  Statistics  Module,  the  user 
can  obtain  information  about  the  star  distribution  in  the  sky  which  may  aid 
him  in  specifying  and  developing  software. 

This  section  discusses  the  subroutines  of  the  Statistics  Module.  Access  Module 
subroutines  referenced  by  the  Statistic  Module  are  detailed  in  Section  8. 

9.1  STATISTICS  MODULE  CAPABILITIES 

The  capabilities  of  the  Statistics  Module  of  program  LOOKAT  are: 

• List  the  contents  of  any  or  all  subcatalogs. 

• Generate  a Core  Catalog  by  referencing  any  of  the  Access  Module 
drivers — FETCH,  BAND,  or  SLICE. 

• Select  stars  from  the  Core  Catalog  for  further  analysis  on  the  basis 
of  any  Core  Catalog  star  data  word  being  within  user-specified 
bounds. 

• Calculate  right  ascensions  and  declinations  of  the  Core  Catalog  stars 
from  the  G.I.  unit  vector.  Store  these  in  any  specified  locations 

of  the  Core  Catalog  arrays. 

• List  the  parameters  used  by  program  CAT  to  create  the  Run  Catalog. 

• Sort  the  Core  Catalog  into  either  ascending  or  descending  order  of 
any  specified  Core  Catalog  data  word. 

• List  the  Core  Catalog  star  data  or  a user-specified  subset  of  the 
Core  Catalog. 

• Count  the  number  of  stars  failing  into  user-specified  bins  defined  by 
reference  to  any  specified  Core  Catalog  star  data  word;  present 
the  results  in  tabular  and  histogram  form. 
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The  histogram  has  an  automatic  scaling  feature  to  assure  that  data 
will  not  have  to  be  truncated.  Counts  above  or  below  the  bin  limits 
are  given  on  separate  lines  of  the  histogram. 

• Define  "bins"  for  any  given  star  data  word  based  upon  user-specified 
zero  point  and  scale  factor,  or  a zero  point  and  scale  factor  derived 
from  a user-specified  member  of  bins  and  the  extreme  values  fqr  the 
star  data  word. 

o Produce  right  ascension  versus  declination  printer  plots  for  the 
Core  Catalog  stars  on  either  a whole-sky  plot  or  a plot  scaled  to 
allow  maximum  resolution. 

® Correlate  any  two  specified  Core  Catalog  star  data  words  using 
either  least-squares  linear  or  quadratic  fits;  and  present  data  in 
tabular  and/or  printer  plot  form. 

• Calculate  mean  errors  before  and  after  the  correlation. 

• Provide  a printer  plot  of  the  correlation  variables.  Optionally, 
add  the  correlation  curve  to  this  plot. 

9.2  STATISTICS  MODULE  OVERVIEW 

The  Statistics  Module  produces  statistical  information  and  plots  of  the  Run 
Catalog  data,  using  as  input  a direct-access  Run  Catalog  created  directly  by 
program  CAT  or  loaded  to  disk  subsequently  by  program  SWITCH.  The  Access 
Module  of  program  LOOKAT  is  used  to  create  Core  Catalogs,  which  are  used  in 
the  statistical  analysis.  An  input  data  set  and  a statistics  driver  routine  direct 
SWITCH  Program  flow. 

9.2.1  Statistics  Module  Logical  Flow 

A baseiine  diagram  of  the  Statistics  Module,  STATS,  is  given  in  Figure  9-1  and 
a logical  flow  diagram  of  STATS  is  presented  in  Figure  9-2.  The  Statistics 
Module  is  entered  by  a call  to  its  driver  subroutine,  STATS.  A NAMELIST  is 
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Figure  9-2.  Logical  Flow  of  the  Statistics  Module  (1  of  10) 


9-4 


ORIGINAL  PAGE  !S 
OF  POOR  QUALITY 


Figure  9-2.  Logical  Flow  of  the  Statistics  Module  (2  of  10) 
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Figure  9-2.  Logical  Flow  of  the  Statistics  Module  (3  of  10) 
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Figure  9-2.  Logical  Flow  of  the  Statistics  Module  (5  of  10) 
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Figure  9-2.  Logical  Flow  of  the  Statistics  Module  (6  of  10) 
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Figure  9-2.  Logical  Flow  of  the  Statistics  Module  (7  of  10) 


?-10 


ORIGINAL  PAGE  IS 
OF,  POOR  QUALITY. 


THE  FOLLOWING 
IS  °ERFOPMED 
IN  SUBROUTINE 
PLOT 


THE  FOLLOWING 
IS  PERFORMED 
IN  SUBROUTINE 
GENPLT 


Figure  9-2. 


Logical  Flow  of  the  Statistics  Module  (8  of  10) 
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Figure  9-2.  Logical  Flow  of  the  Statistics  Module  (9  of  10) 
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Figure  9-2.  Logical  Flow  of  the  Statistics  Module  (10  of  10) 
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read  from  data  set  FORTRAN  reference  number  15.  Program  flow  is  directed 
to  one  of  the  worker  subroutines  based  on  the  value  of  the  NAMELIST  primary 
control  word  ISTAT.  Table  9-1  lists  the  values  the  primary  control  word,  the 
name  of  the  subroutine  to  which  they  direct  program  flow,  and  a brief  description 
of  that  subroutine. 

The  Secondary  Control  Words,  which  were  read  from  the  same  NAMELIST  as 
the  primary  control  word,  control  the  program  flow  within  the  worker  sub- 
routine. After  the  worker  subroutine  completes  its  function,  it  returns  to 
STATS,  which  reads  another  NAMELIST  from  file  15.  The  program  continues 
until 

• A value  of  zero  is  read  for  the  primary  control  word  (STATS 
returns). 

• An  I/O  error  is  encountered  reading  the  Run  Catalog  (program 
STOPS). 

• An  end  of  file  is  encountered  on  file  15  (STATS  returns). 

The  logical  program  flow  for  four  of  the  most  involved  of  the  Statistics  Module 
subroutines  is  discussed  below.  The  other  subroutines  are  described  only 
functionally  in  Section  9.6. 

9.2.2  Subroutine  STPICK 

STPICK  begins  by  checking  the  value  of  the  secondary  control  words  against  a 
set  of  allowed  values.  . 

The  user  specifies  which  star  data  word  is  to  be  the  sorting  variable.  This 
can  be  ISTDAT  or  any  of  the  eight  FSTDAT  words.  A value  of  zero  for  this 
control  word  permits  the  user  to  skip  the  sorting  phase  of  STPICK. 

The  sort  is  accomplished  in  either  ascending  or  descending  order  (user- 
specified)  and  control  then  passes  to  the  printing  phase  of  STPICK. 
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Table  9-1. 


Primary  Control  Word  Values  and  Meanings 


VALUE 

SUBROUTINE 

CALLED 

FUNCTION  PERFORMED 

0 

NONE 

STATS  RETURNS 

1 

STLIST 

LISTS  PARTS  OR  ALL  OF  RUN  CATALOG 

2 

STCATL 

PRODUCES  CORE  CATALOG 

3 

STSLCT 

SELECTS  A SUBSET  OF  THE  CORE  CATALOG 
BASED  ON  THE  VALUE  OF  A SPECIFIED  CORE 

CATALOG  DATA  WORD 

4 

STREST 

RESETS  CORE  CATALOG  TO  WHAT  IS  WAS 
PRIOR  TO  STSLCT  EXECUTIONS 

5 

STALDL 

CALCULATES  AND  STORES  RIGHT  ASCENSION 
AND  DECLINATION 

6 

STPICK 

SORTS  CORE  CATALOG  ON  A SPECIFIED 
VARIABLE  AND  PRINTS  ALL  OR  SPECIFIED 
PARTS  OF  THE  CORE  CATALOG  DATA 

7 

STCONT 

COUNTS  THE  NUMBER  OF  CORE  CATALOG 
STARS  HAVING  THE  VALUE  OF  A GIVEN 
DATA  WORD  IN  EACH  OF  A NUMBER  OF 
SPECIFIED  INTERVALS 

8 

STPLOT 

PRODUCES  ARIGHT  ASCENSION  VERSUS 
DECLINATION  PLOT  OF  CORE  CATALOG 
STARS 

9 

STCORR 

CORRELATES  ONE  CORE  CATALOG  DATA 
WORD  WITH  ANOTHER,  AND  PLOTS  THE 
RESULTS 
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The  user  may  skip  the  printing  phase,  or  he  may  instruct  STPICK  to  print  a 
subset  of  Core  Catalog  data.  The  possible  subsets  are 

o All  data 

• All  data  words  up  through  a given  FSTDAT  location  (for  all  stars) 

• The  relative  array  location,  ISTDAT  and  sorting  variable  (if  other 
than  ISTDAT)  for  any  given  range  of  relative  array  locations 

9.2.3  Subroutine  STCONT 

STCONT  begins  by  checking  the  values  of  the  secondary  control  words  against 
a set  of  allowed  values.  STCONT  then  defines  the  bins  into  which  Core  Catalog 
stars  will  be  counted.  The  bins  are  defined  by  a zero  point,  a bin  size,  and  the 
total  number  of  bins.  These  parameters  are  derived  by  one  of  the  following 
methods : 

o The  user  specifies  the  zero,  scale  and  number  of  bins. 

• The  user  specifies  the  number  of  bins  and  STCONT  calculates  a 
zero  and  scale  which  assure  that  all  stars  will  fall  within  one  of  the 
bins. 

Once  the  bins  are  defined,  STCONT  counts  the  number  of  Core  Catalog  stars 
with  the  user-specified  data  word  value  within  each  bin  limit.  The  number  of 
stars  having  values  below  the  lowest  bin  and  above  the  highest,  if  any,  are  also 
counted. 

STCONT  presents  the  results  in  tabular  and,  optionally,  histogram  form.  The 
scales  are  printed  in  either  decimal  or  exponential  format  depending  on  the 
magnitude  of  the  values  to  be  printed  and  the  interval  between  them.  Decimal 
notation  is  used  unless  four  or  more  characters  before  the  decimal  point  are 
required  for  at  least  one  value  to  be  printed,  or  if  the  scale  is  less  than  0.01. 
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9.2.4  Subroutine  GENPLT  . 

The  plotting  subroutine,  S TP  LOT,  calls  either  subroutine  PLOT  or  subroutine 
GENPLT  to  perform  the  plotting  function.  PLOT  is  relatively  simple;  it  pro- 
duces a full-sky  right  ascension  versus  declination  plot  of  the  Core  Catalog. 
GENPLT  is  more  complex  and  is  described  below.  When  called  by  STPLOT, 
GENPLT  has  many  of  its  capabilities  turned  off  by  hard-coded  calling  sequence 
variables. 

Since  the  user  may  wish  to  call  GENPLT  directly,  we  describe  here  the  full 
capabilities  of  the  subroutine. 

GENPLT  begins  by  blanking  out  the  plotting  array,  LL,  and  then  setting  up  grid 
lines  every  tenth  row  and  column.  A whole  sky  plot  may  be  generated,  or  the 
user  may  specify  automatic  scaling.  The  automatic  scaling  feature  of  GENPLT 
expands  the  scale  to  as  high  a resolution  as  possible  while  still  assuring  that 
all  stars  fall  within  the  bounds  of  the  plot. 

Optionally,  the  zero  points  and  scale  factors  are  slightly  altered  to  ensure  that 
the  grid  points  fall  on  even  multiples  of  0. 1 degrees. 

The  user  has  the  option  of  specifying  character  discrimination.  If  this  option  is 
not  used,  stars  are  printed  as  asterisks.  If  it  is  used,  stars  are  printed  as 
single  digit  integers  from  one  to  nine.  The  value  plotted  is  determined  from 
the  value  of  a user-specified  star  data  word.  The  zero  point  and  scale  factor 
for  character  choice  may  be  user-specified  or  automatically  calculated,  as  for 
right  ascension  and  declination. 

Once  the  character  for  a star  is  chosen,  it  is  entered  into  the  plot  array  at  the 
appropriate  row  and  column.  If  a star  is  already  plotted  there,  an  asterisk 
replaces  the  earlier  character.  When  all  stars  in  the  Core  Catalog  have  been 
processed,  the  LL  array  is  printed. 
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9.2.5  Subroutine  STCORR 

STCORR  begins  by  checking  the  values  of  the  secondary  control  words  against  a 
set  of  allowed  values.  The  two  star  data  words  to  be  correlated  are  specified 
in  these  control  words.  The  user  has  also  specified  that  either  a linear  or  a 
quadratic  least-squares  fit  is  to  be  attempted. 

STCORR  calculates  the  coefficients  of  this  fit  and  prints  them.  It  then  calculates 
and  prints  the  mean  deviation  of  the  first  correlation  parameter  from  its  norm 
before  the  correlation  and  its  mean  residual  after  the  correlation. 

Optionally,  a printer  plot  of  one  variable  against  the  other  is  generated.  This 
is  accomplished  by  blanking  out  a plotting  array,  putting  in  grid  lines  at  every 
tenth  row  and  column,  entering  a character  for  each  star,  and  (optionally*)  en- 
tering the  correlation  curve  across  the  width  of  the  plot.  The  plot  array  is  then 
printed. 

9.3  MATHEMATICAL  SPECIFICATIONS 

9.3.1  Conversion  of  Star  Geocentric  Inertial  Unit  Vectors  to  Right  Ascension, 
Declination 

Conversion  of  the  Star  Geocentric  Inertial  unit  vector  (always  present  on  the 
Run  Catalog)  to  right  ascension  and  declination  is  accomplished  in  subroutine 
STALDL  using  the  utility  subroutine  GITOAD.  The  relevant  equations  are  the 
same  as  those  presented  in  Section  6.3. 1. 

9.3.2  Calculating  Bin  Zero  Point  and  Scale  Factor 

Wnen  employing  subroutine  STCONT  to  count  the  number  of  stars  with  specified 
Core  Catalog  data  word  values  within  various  intervals,  the  user  has  the  option 
of  specifying  only  the  total  number  of  bins  he  desires.  The  Core  Catalog  data 
word  values  are  then  examined  to  establish  a zero  point  and  scaling  factor  such 
that  all  data  falls  within  the  bins  and  the  resolution  is  as  high  as  possible. 
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The  following  formulae  are  used: 


Z 


= V . 
min 


max  min  Dins 


(9-1) 


where  Z = the  zero  point 
S = the  scale  factor 


Nbins  = user -input  number  of  bins 


V . = min  (V  , V ) 
min  l n 


V - max  (V. , ...»  V ) 
max  1 n 


V,  = data  word  value  for  the  ith  star  in  the  Core  Catalog 


n = number  of  stars  in  the  Core  Catalog 


The  ith  star  is  counted  as  being  in  the  jth  bin  provided  that: 


Z + S(j  - 1)  < V.  * z + S. 

i J 


(9-2) 


9.3.3  Determining  the  Zero  Point  and  Scale  Factor  for  a Right  Ascension 
Declination  Plot 

If  the  automatic  scaling  capability  of  subroutine  GENPLT  is  used  to  expand  the 
right  ascension,  declination  plotting  scale,  then  the  two  zero  points  and  scale 
factors  must  be  determined.  This  is  accomplished  in  a procedure  completely 
analogous  to  that  described  in  Section  9.3.2,  with  one  exception  concerning  the 
right  ascension  scale.  Because  right  ascension  may  take  any  value  between 
0 and  360  degrees,  and  because  it  is  a continuous  variable  i.e. , 0 degree  = 
360  degrees),  it  is  desirable  to  be  able  to  expand  a plot  containing  points  at 
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right  ascensions  near,  but  on  both  sides  of,  0 degree.  For  example,  if  five  data 
points  are  to  be  plotted,  with  right  ascensions  4,  7,  2,  358,  and  353  degrees, 
the  normal  technique  of  scaling  would  yield  a zero  point  of  2 degrees  and  a scale 
of  (358  degrees  - 2 degrees)/ll9  =3.  0,  where  119  is  the  number  of  columns  in 
the  plot.  Clearly  a plot  centered  around  0 degree  would  present  a better  scale. 
This  is  accomplished  by  subtracting  360  degrees  from  all  right  ascensions 
greater  than  ISO  degrees.  Then,  the  calculated  zero  would  be,  for  our  example, 
-7  degrees  and  the  scale  would  be  just  over  0. 1 degree,  an  increase  of  a factor 
of  30  in  resolution. 

In  GENPLT,  both  methods  are  used  to  calculate  the  zero  point  and  scale  factor. 
Whichever  method  yields  a higher  resolution  is  used  for  the  plot. 

9.3.4  Calculating  the  Correlation  Curve  Between  Two  Variables 

In  subroutine  STCORR,  least-squares  curve  fits  of  two  specified  star  data  words 
are  calculated.  The  user  may  specify  a linear  or  quadratic  fit. 

9.3.4. 1 Linear  Fit 

If  the  correlation  curve  is  to  be 


x = a + £y 


(9-3) 


where  x,  y are  the  variables  to  be  correlated,  then 


I n n \ 

“■  /n 
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» =(E ^ -SxiEVn)/&Vi -%yi  t; yi) /n ' 

\i=l  i=l  i=l  / a=l  i=l  i=l  / ) 


(9-4) 


where  x^,  y.  = the  ith  data  point 


n = the  number  of  stars  in  the  Core  Catalog 
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9. 3. 4. 2 Quadratic  Fit 

If  the  correlation  curve  is  to  be 


x = a + fiy  + yy 


(9-5) 


then 
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9.4  BASELINE  DIAGRAM  AND  UNIT  DESCRIPTIONS 


9.4.1  Baseline  Diagram 

Figure  9-1  presented  earlier  is  the  baseline  diagram  for  the  Statistics  Module 
driver,  STATS. 

9.4.2  Unit  Descriptions 

A unit  description  of  each  subroutine  in  the  Statistics  Module  is  given  in  Sec- 
tions 9.4.  2. 1 through  9.4.  2. 13.  An  explanation  of  the  tabular  formats  used  in 
these  sections  is  given  in  Section  2.4. 1. 

The  following  is  an  index  to  all  program  LOOKAT  Statistics  Module  subroutines 
and  functions. 


Module 

Reference  Page 

DREAD 

Reference  35 

STATS 

9-23 

GENPLT 

9-30 

PLOT 

9-33 

PZONE 

9-35 

STALDL 

9-37 

STCATL 

9-39 

STCONT 

9-43 

STCORR 

9-46 

STLIST 

9-49 

ST  PICK 

9-52 

STPLOT 

9-55 

STREST 

9-53 

STSLCT 

9-60 
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STATS 


9.  4.  2.1  Subroutine  STATS 

DESCRIPTION:  Subroutine  STATS  is  the  driver  for  the  statistics  module.  A 
card  read  from  file  15  determines  which  statistics  module  subroutine  is  to  be 
called. 

CALLING  SEQUENCE:  Subroutine  STATS  (ISTDAT,  FSTDAT,  STLONG,  NDIM1, 

NDIM2 , NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  STINST 

EXTERNAL  REFERENCES:  STALDL, STCATL, STCONT, STCORR, STLIST, 

STPICK,  STPLOT,  STREST,  STSLCT 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  15  con- 
tains control  card  input.  FORTRAN  data  set  reference  number  16  is  printed 
output. 

ERROR  MESSAGES:  None 


9-23 


INIHIT/OKTPtJT  VAIMAIH.KS  FOR  SlIliROllTINK  STATS 


STATS 


T»' 

v'S\  • <-  s " a 

Of  pccf 


C 2 g 2 - tb 

5 |8Soc® 

- I1  S*  s *2  *o 

o c o zi  ^ 5 

..  O O W c a 

2 i i i tfi  J-  pC 


o 

-*-> 

u 

0 

s 

o 

o 

o 

o 

> 

> 

x 

4*1 

•mt 

•41 

>j 

S 3 3 CS  < 

P ^ 

« • • &«  — ■* 

« « “ ^ r- 

• • • o 

c c 3 = £ 

II  II  II  II 

a 

~ ^ n ^ w 


H H £-  h r* 

< < < < < 

Q Q C p S 

CI3MMKM 

r»  *•_  r_  ww 

^ W 


1 * 

« O 

2 “ 


*-«  sJ 

2 ?P  © 
^ £ o 

^ a » 


u 

2 g> 


0 s 'H  " “ : 

; 

•si  o “ ^ — 

1 « « O « 


X 

I— 

CO 

CO 

CO 

5 

X 

X 

X 

CO 

*-< 

o 

c 

*!2 

^2 

CJ 

s* 

3 

3 

C* 

•* 

•» 

0 

o 

M 

rs 

•s 

II 

II 

II 

ii 

w 

CO 

• 

• 

• 

• 

• 

• 

z 

w 

O 

c.s 

c.s 

c.s 

c.s 

c.s 

c.s 

H 

CO 

2 Z 


* <= 


2 — 

Q £ 

t*  ?? 

3 z 


■M 

< 

O 

2 

< 

a 

Z 

z 

2 

9-24 


IN  PI  IT/ OUTPUT  VARIABLES  FOR  SUI3KOUTINK  STM’S 


ORIGINAL  PAGE  IS 
OF  POOR  QUALITY 


STATS 


u 

0 

CO 

0 


H 

co 

a 


G 

Q 


e-  h a 
2 o 
O G o 
O ft  G 


a 

c 


p 

_5 

S 

CO 

>> 

o 

T3 

0 

w 

G 

u 

0) 

c 

0 

bC 
C 
(— » 
G 

G 

0 

be 


CO 

C 

'g 

o 

0 

G 

CO 

0 

O 

u 

be 

0 

•pH 

l 

II 

H 

T3 

< 

33 

G 

0 

■G  ?h 

'O 

S H 

G 

C 

4 

o 

o 

"O 

T3 

C3 

G 

c 

- c; 

CO 

C "c 

a?  o 
o w 

CO  co 
53  , 


A 

O 

CO  ^ 

c >> 

0 rb 
o 53 
« O 
w 

S * 
■a  o 

‘S  ^ 

OT  II 
* £-i 

cs  < 
O 


it  ffl  50 


H 

co 

H 

co 

H 

co 

CO 

Eh 

CO 

Eh 

CO 

0 

ft 

o 

c 

be 

•w 

M 

oq 

li 

c 

0 

>1 

Ej 

CQ 

■G 

G 

w 

G 

G 

CO 

F*< 

co 

CO 

l-H 

CQ 

CO 

l-H 

CO 

r-H 

H 

2 

u 

uO 

CH 

ft 

o 

X 

G 

0 

•rM 

O 

•ml 

lb 

t-H 

G 

lb 

rt 

lb 

i-H 

G 

i£  H 

3 

< 

CQ 

0 

0 

fH 

>»-> 

a 

"S, 

0 

O 

0 

0 

0 

0 

fi 

M 

G 

G 

c 

G 

o 

o 

«k 

A 

•» 

* 

*« 

* 

G 

#k 

•k 

G 

CO 

Sh 

«k 

LO 

o 

t> 

00 

as 

G 

1—1 

N 

CO 

*a 

Eh 

G 

0 

be 

0 

■s. 

oq 

II 

II 

li 

il 

It 

ll 

G 

11 

11 

li 

co 

HH 

CO 

c 

ll 

CO 

_ -53 

G 


0 
a 

be  a 
a *G 

rt  ^ 

1 S 

co  co 


CO  CO 


G 

a 

-4-» 

ft 
o 

rs 

5 

CO 

„ 13 

^ G 


o 

co 

» 

£h 

< 

O 

p* 


CO 

© 

© 

be 

a 

T3 


O 

be 

c 

C3 

u 

G 

3 

o 

CO 

co 

•R 

G 

G 


co 

_ 

* * 
Cw  i— i 


.2  « 

"a  ^ 
o o 

o <M 


C — 

a 

co  G 

o ° 
GC  co 

-i-i 

c o 
0 w 

0 CSJ 
? II 
CD  ^ 

aS 

be  ^ 


O CO 
•rt  0 
G g 
0 u 

p-H  0 

0 -O 

o .5 


CO 

CO 

0 

o 

a 

w 


li 

H 

< 

G 


g 33 

0 3 

£ 0 

S be 
-a  0 

G ^3 
O £ 

2 — i 


G — > 
/■■*  — 

G 

1 S- 

oe  g 

5 3 

< co 


\ 

\ 

\ 

\ 

Eh 

Eh 

. Eh 

Eh 

E- 

CO 

CO 

CO 

CO 

CO 

2 

2 

2 

2 

2 

Eh 

Eh 

CH 

ch 

& 

CO 

CO 

co 

\ 

\ 

\ 

\ 

0 

o 

0 


g 

2 

P 

CO 


Cl 

CO 

£ 

P 

CO 


0 

£ 


* 


? 


* 


G1  Tf 

* * 

CS  tf 


coj 


— CD 


G 

2 


§ 

o 

H 

< 

c 

c- 

in 


H 

< 

C 

> 


o 
>— » 
u 

2 

>-H 

cu 

t: 

< 

2 

G 

CO 


G 

G 

X 

% 


< 

X 

< 

r 


e- 

fr 


> 


9-25 


INPUT/ OUTPUT  VAHIAII1.KS  K«ll  SUlHtOUTINIO  STA'I’S 


STATS 


tD  2 


2S  M 


ORIGINAL  PAGE  !5 
Of  POOR  QUALITY 


— to 

c-S 


o a w 

^ cj 


0 

bf  X 

3 

"2 

* * 

a « 

r M 

-w 

CO 

g 

w 

? ? 
M 

o 2 

"w 

Mi 

CtS 

72 

3> 

W 

il 

C 

O 

— 

^ — • 

cp 

a 

‘5? 

s 

< 

w j5 

c? 

3 ? 

£ 

0 3 
S a 

2L 

5 

•w  — 

>>  5 

— 

£fi  3 

3 5 

-b 

2 *3 

3 jS 

**  cm 

w 

•5  'a 

*,  ^ 

CJ  -0 

CJ  ~ 

rs 

3 £ 

^ D 
^3  S 

O 

^ p 2 — 2 S.  s 5 

3 i 1 ^ ^ ~ 

* ° 25  s s r -s  f = 

O ^ S*  «■»  •*_> 

t?  w r g r co  w w r 

— 3 IQ  wC...  rtJsC. 


5 -•  n n v « 

% II  II  II  II  II 


\ 

\ 

\ 

N 

N 

Jt 

r* 

C* 

So 

co 

CO 

72 

So 

CO 

Z 

z 

2 

2 

2 

2 

*— * 

r* 

3" 

•"* 

“-4 

31 

CO 

a: 

CO 

CO 

JO 

CO 

\ 

N 

\ 

N 

N 

N 

'J  > 

< -- 


9-26 


IPPAl.l.  O 1*4  /ST1NST/  (Valid  for  IF  PUNT  = 4 or  5 only) 

= 1,  print  data  for  all  zones  available  in  the  run  catalog 
- 2,  print  data  for  zones  listed  on  the  following  records 
only. 
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9. 4. 2. 2 Subroutine  GENPLT 

DESCRIPTION:  Subroutine  GENPLT  creates  a plot  of  the  star  catalog  using 
as  large  a scale  as  possible.  If  desired,  one  variable  may  be  chosen  for  plot 
character  discrimination.  Automatic  scaling  is  available,  but  not  mandatory. 

CALLING  SEQUENCE:  Subroutine  GENPLT  (IPLTFL, IFRADC , IFAUTO , 

ALPZ,ALPSC,  DECZ,  DECSC, 

IC  HA  R V , IFC  A UT , CHARZ, 
CHARSC , IFREG , ISTDAT , 
FSTDAT,  STLONG,  NDIM1,  NDIM2, 
NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  PARAMS 
EXTERNAL  REFERENCES:  GITOAD 

INPUT/OUTPUT  DATA  .SETS:  FORTRAN  data  set  reference  number  16  is 
printed  output.  FORTRAN  data  set  reference  number  IPLTFL  is  printed  plot 
output. 
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INPUT/OUTPUT  VARIABLE'S  FOR  SUBROUTINE  GENPLT 
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9.  4.  2. 3 Subroutine  PLOT 

DESCRIPTION:  Subroutine  PLOT  produces  a printer  plot  of  the  stars  in  the 
Core  Catalog. 

CALLING  SEQUENCE:  Subroutine  PLOT  (IPLTFL,IFRADC,ISTDAT, FSTDAT, 

NDIM1 , NDIM2 , NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES 
EXTERNAL  REFERENCES:  GITOAD 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
printed  output.  FORTRAN  data  set  reference  number  IPLTFL  is  printed  plot 
output. 
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9.  4.  2.  4 Subroutine  PZONE 

DESCRIPTION:  Subroutine  PZONE  prints  either  a summary  of  the  data  concern- 
ing a zone,  or  all  data  for  the  zone. 


CALLING  SEQUENCE:  Subroutine  PZONE  (IP.IA) 

COMMON  AREAS  REFERENCED:  FERMSG,  FILES,  PARAMS,  POINT 
EXTERNAL  REFERENCES:  DREAD 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
printed  output. 

ERROR  MESSAGES: 


’READ  ERROR  ON  RUN  CATALOG  FILE. . . PROGRAM  STOPS.  DAIO  ERROR 
MESSAGE  FIELD  IS  ZZZZZZZZ  mm  AAAAAAAAAAAAAAAAAAAAAAAAAA 


AA  ZZZZZZZZ  ZZZZZZZZ  ZZZZZZZZ  ZZZZZZZZ’.  The  Z,I  and  A fields 
indicated  are  hexidecimal,  integer  and  alphameric  information,  respectively 
from  the  DAIO  error  return  fields.  The  user  must  determine  what  error  oc- 
curred by  consulting  Reference  35  under  ’’Data  Management  Techniques"  and 
take  appropriate  action. 
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9.  4.  2.  5 Subroutine  STALDL 

■»  r 

DESCRIPTION:  Subroutine  STALDL  calculates  right  ascensions  and  declinations 
of  the  catalog  stars,  and  stores  them  in  user  specified  positions  of  the  FSTDAT 
array. 

CALLING  SEQUENCE:  Subroutine  STALDL  (ISTDAT,  FSTDAT,  NDIM1, 

NDIM2 , NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  STCOM,  STINST 
EXTERNAL  REFERENCES:  GITOAD 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
printed  output. 

ERROR  MESSAGES: 

'AN  ILLEGAL  VALVE  FOR  THE  FSTDAT  POSITION  WAS  INPUT.  RIGHT  AS- 
CENSION AND  DECLINATION  ARE  STORED  IN  POSITIONS  7 AND  8 RESPEC- 
TIVELY. ' The  user  is  only  allowed  to  store  right  ascension  and  declination  in 
positions  4,  5,  6,  7 or  8 of  FSTDAT. 
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9 . 4.  2.  6 Subroutine  STCATL 

DESCRIPTION:  Subroutine  STCATL  generates  a star  catalog  in  the  ISTDAT 
and  FSTDAT  arrays.  In  accordance  with  instructions  read  from  file  15,  and 
by  using  access  module  driver  subroutines. 

CALLING  SEQUENCE:  Subroutine  STCATL  (I FRST,  ISTDAT,  FSTDAT, 

STLONG,  NDIM1 , NDIM2, 
NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  PARAMS,  STCOM,  STINST 
EXTERNAL  REFERENCES:  BAND,  FETCH,  SLICE 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
printed  output. 

ERROR  MESSAGES:  None  . 
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9. 4. 2. 7 Subroutine  STCONT 

DESCRIPTION:  Subroutine  STCONT  counts  how  many  stars  fall  into  each  bin. 
Bins  are  defined  in  a user-specified  manner  for  a user-specified  variable. 
Optionally,  a histogram  is  printed. 

CALLING  SEQUENCE:  Subroutine  STCONT  (ISTDAT,  FSTDAT,  NDIM1, 

NDIM2 , NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  STCOM,  STINST 
EXTERNAL  REFERENCES:  None 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
printed  output. 

ERROR  MESSAGES:  None 
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DESCRIPTION:  Subroutine  STCORR  correlates  any  two  star  catalog  variables. 
Either  a least  squares  linear  or  quadratic  fit  is  used.  A plot  of  one  variable 
against  the  other,  and  the  correlation  curve,  is  given. 


CALLING  SEQUENCE:  Subroutine  STCORR  (ISTDAT,  FSTDAT,  NDIM1, 

NDIM2 , NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  STCOM,  STINST 
EXTERNAL  REFERENCES:  None 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  15  contains 
control  card  input.  FORTRAN  data  set  reference  number  16  is  printed  output. 

ERROR  MESSAGES:  None 
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9. 4.  2. 9 Subroutine  STLIST 

DESCRIPTION:  Subroutine  STLIST  produces  a listing  of  star  catalog  defini- 
tional parameters  contained  in  the  first  eight  logical  records  of  the  Run  Cata- 
log. Through  subroutine  PZONE,  it  can  also  cause  subcatalogs  to  be  entirely 
printed  . 

CALLING  SEQUENCE:  Subroutine  ST  LIST  (ISTDAT,  FSTDAT,  NDIM1,  NDIM2 , 

NUMCAT) 

COMMON  AREAS  REFERENCED:  FERMS  G,  FILES,  PARAMS,  POINT, 

STINST 

EXTERNAL  REFERENCES:  DREAD,  PZONE 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  15  contains 
control  card  input.  FORTRAN  data  set  reference  number  16  is  printed  output. 

ERROR  MESSAGES: 

'RUN  CATALOG  READ  ERROR  IN  STLIST.  THE  FOLLOWING  IS  THE  DAIO 
ERROR  BLOCK 

zzzzzzzz  mm  aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 

AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 

zzzzzzzz  zzzzzzzz  ZZZZZZZZ  ZZZZZZZZ' 

The  Z,  I,  and  A fields  indicated  are  hexadecimal,  integer  and  alphameric  infor- 
mation, respectively,  from  the  DAIO  error  return  fields.  The  user  must  deter- 
mine what  error  occurred  by  consulting  Reference  35  under  "Data  Management 
Techniques’’  and  take  appropriate  action. 
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9.4.2.10  Subroutine  STPICK 

DESCRIPTION:  Subroutine  STPICK  sorts  the  Core  Catalog  in  either  ascending 
or  descending  order  of  a star  data  word.  Additionally,  it  lists  all  or  part  of 
the  star  data  in  sorted  order. 

CALLING  SEQUENCE:  Subroutine  STPICK  (ISTDAT,  FSTDAT,  NDIM1, 

NDIM2 , NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  STCOM,  STINST 
EXTERNAL  REFERENCES:  None 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  15  con- 
tains control  card  input.  FORTRAN  data  set  reference  number  16  is  printed 
output. 

ERROR  MESSAGES:  None 
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9.4.2.11  Subroutine  STPLOT 

DESCRIPTION:  Subroutine  STPLOT  produces  a plot  of  the  star  catalog  using 
the  plot  and  GENPLT  routines. 

CALLING  SEQUENCE:  Subroutine  STPLOT  (ISTDAT,  FSTDAT,  NDIM1, 

NDIM2,  NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  STCOM,  STINST 
EXTERNAL  REFERENCES:  GENPLT,  PLOT 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  15  con- 
tains control  card  input. 

ERROR  MESSAGES:  None 
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9. 4. 2. 12  Subroutine  STREST 

DESCRIPTION:  Subroutine  STREST  causes  the  Core  Catalog  to  be  reset  to  what 
it  was  the  last  time  STCATL  was  called. 

CALLING  SEQUENCE:  Subroutine  STREST  (1ST  DAT,  FSTDAT,  ST  LONG, 

NDIM1,  NDIM2,  NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES 
EXTERNAL  REFERENCES:  STCATL 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  16  is 
printed  output. 

ERROR  MESSAGES:  None 
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9. 4.  2. 13  Subroutine  STSLCT 

DESCRIPTION:  Subroutine  STSLCT  selects  stars  from  the  Core  Catalog  for 
further  processing  on  the  basis  of  one  of  the  star  data  words  being  within  user- 
specified  bounds.  Overwriting  of  the  ISTDAT  and  FSTDAT  arrays  occurs,  so 
that  previously  stored  data  is  lost. 

CALLING  SEQUENCE:  Subroutine  STSLCT  (ISTDAT,  FSTDAT,  NDIM1, 

NDIM2,  NUMCAT) 

COMMON  AREAS  REFERENCED:  FILES,  STCOM,  STINST 
EXTERNAL  REFERENCES:  None 

INPUT/OUTPUT  DATA  SETS:  FORTRAN  data  set  reference  number  15  con- 
tains control  card  input.  FORTRAN  data  set  reference  number  16  is  printed 
output. 

ERROR  MESSAGES:  None 
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9.5  COMMON  AREA  DESCRIPTIONS 

In  this  section,  we  present  descriptions  of  the  COMMON  areas  peculiar  to  the 
Statistics  Module  of  LOOKAT.  These  COMMON  blocks  also  appearing  in  the 
Access  Module  are  described  in  Section  8.  5. 
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9.5.1  COMMON/STCOM/ 

DESCRIPTION:  STCOM  contains  the  word  giving  the  number  of  stars  remaining 
in  the  Core  Catalog  after  selection  has  taken  place  in  subroutine  STSLCT. 

FORM:  COMMON/STCOM/NCAT 

REFERENCED  BY:  STALDL,  STCATL,  STCONT,  STCORR,  STPICK, 

STPLOT,  STSLCT 

DEFINITION  OF  VARIABLES: 

Name  Type  Description 

NCAT  1*4  Number  of  stars  in  the 

Core  Catalog  after 
selection 
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9.5.2  COMMON/STINST/ 

DESCRIPTION:  STINST  contains  the  primary  and  secondary  control  words 
which  direct  Statistics  Module  execution. 

FORM:  COMMON/STINST /ISTAT,  ITYCAT,  SPINRA,  SPINDC,  OPAXRA, 
OPAXDC,  IOPTYP,  RANGE,  COELEV,  TOLER,  SLOP,  IF  MAG, 
FMAGLM,  IFFOV,  FOV,  IFPRNT,  IF  PALL,  IZONEP,  ISELCT, 
SELMIN,  SELMAX,  ISLMIN,  ISLMAX,  IRAPUT,  IDCPUT,  ISORT, 
IORDER,  ISRTPR,  IPRBEG,  IPREND,  ICOUNT,  NBINS,  ZERO, 
SCALE,  IFHIST,  ITYPLT,  IPLTVR,  ICORRA,  ICORRB,  ICRDEG, 
ICRPLT 

REFERENCED  BY:  STALDL,  STATS,  STCATL,  STCONT,  STCORR,  STLIST, 

STPICK,  STPLOT,  STSLCT 

DEFINITION  OF  VARIABLES:  The  variables  in  COMMON/STINST/  are  identi- 
cal to  those  of  NAMELIST/STAT/.  See  Section  9.  6. 1. 1 for  a description  of 
each  variable. 
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9.6  USER'S  MANUAL 

This  section  will  enable  the  user  to  formulate  the  appropriate  Job  Control 
Language  (JCL),  create  the  proper  input  NAMELIST  and  interpret  the  resulting 
output  from  the  Statistics  Module  of  program  LOOKAT. 

9.6.1  Input  to  the  Statistics  Module 

Input  to  the  Statistics  Module  consists  of  a direct-access  Run  Catalog  created 
by  program  CAT  and  loaded  onto  disk  by  program  CAT  or  program  SWITCH, 
and  a data  file  of  NAMELISTS  read  from  FORTRAN  data  set  reference  num- 
ber 15.  The  Run  Catalog  is  the  same  as  that  used  for  the  Access  Module  (see 
Section  8.  6. 1).  The  NAMELIST  data  set  is  described  in  Section  9.  6. 1. 1.  Modi- 
fications to  the  code  to  run  the  Statistics  Module  as  a stand-alone  program  are 
presented  in  Section  9.  6. 1. 2. 

9.  6. 1. 1 The  NAMELIST  Data  Set 

Program  flow  through  the  Statistics  Module  is  directed  by  control  words  read 
from  NAME  LIS  T/STAT/  on  FORTRAN  data  set  reference  number  15  (a 
COMMON/FILES/  parameter).  The  driver  routine,  STATS,  reads  a NAMELIST 
containing  the  primary  control  word  and  secondary  control  words.  The  following 
table  describes  each  NAMELIST/STAT/  variable.  These  are  identical  to  the 
variables  in  COMMON/STINST/. 

FORM:  NAME  LIST/ STA T/ISTAT , ITYCAT,  SPINRA,  SPINDC,  OPAXRA, 
OPAXDC,  IOPTYP,  RANGE,  COE  LEV,  TOLER,  SLOP,  IFMAG, 
FMAGLM,  IFFOV,  FOV,  IFPRNT,  EFPALL,  IZONEP,  ISELCT, 
SELMIN,  SELMAX,  ISLMIN,  ISLMAX,  IRAPUT,  IDCPUT,  ISORT, 
IORDER,  ISRTPR,  EPRBEG,  IPREND,  ICOUNT,  NBINS,  ZERO, 

SCALE,  IFHIST,  ITYPLT,  EPLTVR,  ICORRA,  ICORRB,  ICRDEG, 
ICRPLT 
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Subroutines 
Using  Var- 

Name  Type  Default  iable Description 

ISTAT  1*4  0 STATS  Primary  control  word,  directs 

program  flow  to  a worker  sub- 
routine. 

= 0,  returns  to  calling  routine 
= 1,  calls  STLIST 
= 2,  calls  STCATL 
= 3,  calls  STSLCT 
= 4,  calls  STREST 
= 5,  calls  STALDL 
= 6,  calls  STPICK 
= 7,  calls  STCONT 
= 8,  calls  STPLOT 
= 9,  calls  STCORR 


ITYCAT 

1*4 

1 

STCATL 

Catalog  type  flag — catalog 
generated  by  subroutine 
= 1,  FETCH 
= 2,  BAND 
= 3,  SLICE 

SPINRA, 

SPINDC 

R*4 

0.0, 

0.0 

STCATL 

Spin  axis  right  ascension  and 
declination  in  degrees 
(ITYCAT  = 2 or  3 only) 

OPAXRA, 

OPAXDC 

R*4 

0.0, 

0.0 

STCATL 

Sensor  optical  axis  right  as- 
cension and  declination  in 
degrees  (ITYCAT  = 1 or  3 only) 

IOPTYP 

1*4 

1 

STCATL 

Optical  axis  flag 
= 1,  optical  axis  input  is  its 
starting  point 

= 2,  optical  axis  input  is  its 
midpoint  (ITYCAT  = 3 
only) 

RANGE 

R*4 

360.0 

STCATL 

Optical  axis  scan  range  in 
degrees  (ITYCAT  = 3 only) 

COE LEV 

R*4 

0.0 

STCATL 

Coeievation  angle  between  the 
spin  axis  and  optical  axis,  in 
degrees  (ITYCAT  = 2 or  3 onlvt 

TOLER 

R*4 

1.0 

STCATL 

Angular  separation  between 

successive  optical  axis  sample 
points,  in  aesrees  (ITYCAT  = 

2 or  3 only  ) 
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Name 

Type 

Default 

Subroutines 
Using  Var- 
iable 

Description 

SLOP 

R*4 

0.0 

STCATL 

Error  factor  in  the  spin  axis 
position,  including  secular 
motion,  precession  and  nuta- 
tion, in  degrees  (ITYCAT  = 

2 or  3 only) 

IF  MAG 

1*4 

0 

STCATL 

Magnitude  sort  flag  - 
= 0,  do  not  reject  stars  fainter 
than  the  limiting  magni- 
tude 

= 1,  reject  stars  fainter  than 
the  limiting  magnitude 

FMAGLM 

R*4 

9.9  x 1010 

STCATL 

Limiting  magnitude 

IFFOV 

1*4 

0 

STCATL 

Field -of-view  select  flag  - 
= 0,  do  not  reject  stars  out- 
side of  the  FOV 

= 1,  reject  stars  outside- of  the 
FOV 

FOV 

R*4 

180.0 

STCATL 

Radius  of  a circular  field-of- 
view  or  half  side  length  of  a 
square  field-of-view,  in  de- 
grees 

IFPRNT 

1*4 

1 

STLIST 

Function  flag  - 
= 1,  print  only  Run  Catalog 
title  and  header 
= 2,  also  print  row  definition 
parameters 

= 3,  also  print  pointer  array 
= 4,  also  print  zone  definition 
parameters 

= 5,  print  all  Run  Catalog  data 

IF  PALL 

1*4 

1 

STLIST 

(Valid  for  IFPRNT  = 4 or  5 

only) 

= 1,  print  data  for  all  zones 
available  in  the  Run  Cata- 
log 
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Subroutines 
Using  Var- 


Name 

Type 

Default 

iable 

Desc  ription 

= 2,  print  data  for  zones  listed 
on  the  following  records 
only. 

IZONEP(IOO) 

1*4 

100*0 

STLIST 

Zone  numbers  to  be  printed 
(IFPALL  = 2 only) 

ISELCT 

1*4 

0 

STSLCT 

Variable  on  which  selection  test 
is  to  be  performed  - 
= 0,  no  selection  to  be  done 
= 1 through  8,  selection  done 
on  FSTDAT  ( *,  ISELCT) 

= 9,  selection  done  on  ISTDAT 

SELMIN, 

SELMAX 

R*4 

0.0, 

0.0 

STSLCT 

Selection  limits — stars  selected 
must  have  selection  data  vari- 
able values  greater  than 
SELMIN  and  less  than  SE LMAX 
(ISELCT  = 1 through  8 only) 

ISLMIN, 

ISLMAX 

1*4 

* 

o o 

STSLCT 

Selection  limits — stars  selected 
must  have  selection  data  vari- 
able values  greater  than  ISLMIN 
and  less  than  IS  LMAX 
(ISELCT  = 9 only) 

IRAPUT, 

IDCPUT 

1*4 

^ 00 

STALDL 

Locations  in  the  FSTDAT  array 
where  right  ascension  and  de- 
clination, respectively,  are  to 
be  stored.  (Must  be  4,  5,  6, 

7 or  8,  and  IRAPUT  T IDCPUT) 

ISORT 

1*4 

0 

STPICK 

Sort  variable  flag  - 
= 0,  do  not  sort 

= 1 through  8,  sort  on  FSTDAT 
(*,  ISORT) 

= 9,  sort  on  ISTDAT 

IORDER 

1*4 

1 

STPICK 

Sort  order  flag  - 

= 1,  sort  in  ascending  order 
= 2,  sort  in  descending  order 
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Name 

ISRTPR 


IPRBEG, 

IPREND 

ICOUNT 

NBINS 

ZERO 

SCALE 

IFHIST 


NCAT- 


ORIGINAL 

OF  POOR  QUALITY 


Subroutines 
Using  Var- 

Tvpe  Default  iable Description 

1*4  0 STPICK  Print  flag  - 

= 0,  print  nothing 
= 1,  for  all  stars  print  ISTDAT 
and  FSTDAT  (*,  ISORT) 

= 2,  print  ISTDAT  and  FSTDAT 
(*,  ISORT)  of  stars  located 
in  relative  positions 
IPRBEG  to  IPREND  of  the 
Core  Catalog  arrays  only 
= 3 through  8,  print  ISTDAT, 
and  FSTDAT  (*,  1)  through 
FSTDAT  (*,  ISRTPR)  for 
all  stars 


1*4 

1. 

NCAT* 

STPICK 

First  and  last  positions  in  the 
catalog  arrays  to  be  printed 
( ISRTPR  = 2 only) 

1*4 

0 

STCONT 

Count  variable  indicator  - 
= 0 or  9,  do  nothing  (return) 

= 1 through  8,  count  variable 
is  FSTDAT  (*,  ICOUNT) 

1*4 

10 

STCONT 

Number  of  bins  into  which  stars 
are  sorted 

1*4 

0.0 

STCONT 

Zero  point  for  bin  definition — 
i.  e. , lower  limit  of  lower  bin 

R*4 

Automatic 

Scaling 

STCONT 

Scale  for  bin  definition.  If 
SCALE  = 0.0,  STCONT  uses 
automatic  scaling  (see  Sec- 
tion 9.3.2) 

1*4 

0 

STCONT 

Histogram  print  flag  - 

= 0,  do  not  print  histogram  of 
the  results 


= 1,  print  histogram  of  the  re- 
sults 


The  number  of  stars  in  the  Core  Catalog. 


9-70 


ORIGINAL  PAGE  !S 
OF  POOR  QUALITY 


»,  »<  ' 


Name 

ITYPLT 


IPLTVR 


ICORRA, 

ICORRB 


ICRDEG 


ICRPLT 


Subroutines 
Using  Var- 

Tvpe  Default  iable Description 

1*4  1 STPLOT  Type  plot  to  be  generated  - 

= 1,  whole  sky  plot  (uses  sub- 
routine PLOT) 

= 2,  amplified  scale  plot, 
ploting  only  that  part  of 
sky  covered  by  the  Core 
Catalog  (uses  subroutine 
GENPLT). 


1*4 


1*4 


0 


0, 

0 


STPLOT  Plot  character  determined  from 

the  value  of  the  variable  - 
= 0,  9 none  (use  *) 

= 1 through  8,  FSTDAT 
(*,  IPLTVR) 

STCORR  Correlation  variable,  corre- 

late FSTDAT  (*,  ICORRA) 
versus  FSTDAT  (*,  ICORRB). 

If  either  ICORRA  or  ICORRB  = 

0 or  9,  STCORR  returns 


1*4  0 STCORR  Type  of  correlation 

= 0,  none 

= 1,  least  squares  linear  fit 

(ICORRA)  = a + 0 (ICORRB) 
= 2,  least  squares  quadratic  tit 
(ICORRA)  = o;+  3 (ICORRB) 
+ y (ICORRB)2 

1*4  0 STCORR  Plot  flag  - 

= 0,  do  not  plot 
= 1,  plot  ICORRA  versus 
ICORRB 

= 2,  plot  ICORRA  versus 

ICORRB  including  the  cor- 
relation curve 


Figure  9-3  is  a sample  set  of  NAMELISTS.  The  primary  control  word  directs 
STATS  to  call  a specific  worker  subroutine. 

The  secondary  control  words  provide  the  instructions  necessary  for  the  sub- 
routine called  by  STATS. 
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INPUT 

NAMELIST 

SSTAT 

ISTATrl, 

SEND 

IFPRNT=3, 

A 

SSTAT 
I STAT=i, 
SEND 

I FPRNT , I FPAL  L=  1 , 

3 

SSTAT 

ISTAT=1, 

SEND 

I FPRNT=  5 . I FPAl_L=2 , [ ZONEP(l)=2 , l,  5 , ?7::2 

C 

SSTAT 
I STAT  = 2 , 
SEND 

ITYCAT=l,OPAXRA=lGO.O,OPAXDC=?0.0,FOV=il.3, 

D 

SSTAT 

i stat=6, 

SEND 

I SORT=Q , I ORDERS?  , ! SRTDR=3, 

SSTAT 
I STAT=  5/ 
SEND 

I SELCT=^,SELMIN=-9 . 3E1C , SELMAX=5 . C , 

F 

Cr  S l A T 

IS7AT=6, 

SEND 

ISORT=3, I ORDE  R=C , ISRTPR=:, 

G 

SSTAT 
I STAT=~, 
SEND 

- 

SSTAT 
I S TAT=  5 , 
SEND 

I SO RT=0 , IORDE R = 0, ISRTPR=E, 

I 

SSTAT 
I S TAT  = 5 / 
SEND 

[ RAPUT  = 7, IDCPUTs?, 

- 

SSTAT 

ISTAT=o, 

SEND 

I50RT=0, I ORDERS  Z , ISRT?R=:, 

*< 

SSTAT 

ISTAT=S, 

SEND 

I SORT ~'d , I ORDER=i,  I5RTPR=1, 

SSTAT 

istat=6, 

SEND 

ISORT=3, IORDER=2, I5R7?R=2, I 3RSEG=  2> IPREND=2S, 

M 

SSTAT 

ISTAT=7, 

SEND 

I COUNTS,  NBINS  = iO,  I FH  IS  1=2, 

■N 

SSTAT 
1ST  AT  =7  / 
SEND 

I COUNTS,  NB  INS  = 2,  ZERO=3. 2,SCALE=1.  j,  I FH!ST=i, 

0 

SSTAT 

ISTAT=7, 

SEND 

ICOUNT=!;yNBINS  = 50/ IFH!ST  = C, 

P 

SSTAT 
I5TAr=  3, 
SEND 

ITYPLTsl, IPLTVRsC, 

*\ 

SS  TAT 

istat=5, 

SEND 

I TYPLT=2, IPLTVRs-, 

R 

SSTAT 
I S TAT  = $ , 
SEND 

[ CORRA=  3 , ICORRB  = 3,ICRDEG='_,  IC  = °L‘r=:, 

SSTAT 

I S TAT=9 , 
SEND 

I CO RR A=  2 f ICORRB=5, I C?OEG=2, I CRPLT= 2, 

T 

SSTAT 
1ST  AT=C , 
SEND 

•J 

Figure  9-3.  NAMELIST  Input  to  the  Statistics  Module  (Cor- 
responding Output  in  Figures  9-5  to  9-15) 
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When  the  worker  subroutine  completes  its  function,  control  is  returned  to  sub- 
routine STATS,  which  reads  another  NAMELIST/STAT/  and  calls  the  worker 
subroutine  indicated.  This  process  continues  until  an  end  of  file  is  encountered 
on  file  15,  or  a value  of  zero  is  read  for  the  primary  control  word. 

Default  values  for  all  NAMELIST  parameters  are  set  prior  to  the  first  NAMELIST 
read.  Explicit  coding  of  any  NAMELIST  parameter  to  0 or  0.  0 results  in  the 
default  value  of  that  parameter  being  used. 

NAMELIST  reads  alter  only  those  parameters  which  appear  explicitly  in  the 
NAMELIST.  Additionally,  each  NAMELIST  variable  is  used  by  only  one  sub- 
routine. Therefore,  if,  for  example,  the  same  function  is  to  be  performed 
several  different  times  during  one  run,  all  NAMELISTS  calling  for  this  function 
after  the  first,  need  only  contain  the  value  for  the  primary  control  word. 

9.  6. 1.  2 User  Source  Code  Modifications 

The  Statistics  Module  is  a collection  of  subroutines,  used  together  with  Access 
Module  subroutines.  There  is  no  main  routine.  However,  if  the  Statistics 
Module  is  to  be  used  in  a stand-alone  capacity,  subroutine  STATS  can  easily  be 
converted  to  a main  routine.  Figure  9-4  is  a listing  of  subroutine  STATS  which 
indicates  how  this  is  accomplished. 

9.6.2  Output  From  the  Statistics  Module 

Output  from  the  Statistics  Module  consists  of  printed  output  on  FORTRAN  data 
set  reference  numbers  16  and  IPLTFL  (plot  output).  Error  messages  and 
diagnostic  output  may  be  generated  by  Access  Module  subroutines  used  in  con- 
nection with  the  Statistics  Module  (see  Sections  8.  6.4. 1 and  8.  6.  4. 2)  on 
FORTRAN  data  set  reference  number  IDFL. 

A sample  output  has  been  generated  to  demonstrate  the  major  capabilities  of 
the  output  module. 
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OF 


rV  - - 


pros  is 


■ ^ ‘ ^ . V - 1«»  -'  * -•»  l-^I^Uf  1 ^ . ™~,T  - ^ 1.  . . . ..  - ' 

-1-SUBR3-UT  I NE  S-T  AT  S<  1 STD  AT  . FST-DA  T . ST  lOnU  «NCI  Ml  .NCI  M2«-NUMCAT) 


**************** ***** ****** ******  **********  ******  ******************  **  *35000200 


c 

c 

SUBROUTINE  STATS  IS  THE  DRIVES  FOR  THE  STATISTICS 
MODULE.  A CARD  READ  FROM  FILE  15  DETERMINES 

— jqooosoo 

35000400 

35000500 

c 

c 

WH  1CH  STATIST  I CS  MODULE  SUBROUTINE  IS  TC  BE  CALLED.  ~~ 

AUTHOR.  CAVtO  GOTTLIEB.  CCMPUTF0  SCIENCES  CQRP. 

— 3'5O006V0 

35000700 

c 

c 

WRITTEN.  AUGUST  1.  1975. 

35666966 

35001000 

c 

c 

£aT  fRNAL  REFERS  Wl  ES  ...  5 TL  I 3 T . 5T  t.  AT  L » 5T5L«-T# 
STREST.  STALDL.  STPICK.  STCONT.  STPLOT*  STCORR 

3 500 1 1 00  — — 

35001200 

35001300 

c 

c 

***************************************  **********  ************  ******  ***35001  400 

35001500 

K!Tn;.M 

NAMEL I ST/STAT/^ST AT  . I T YC  A T , SP  I Nfi  A . 3 P 1 NO  C . OP  AX  fi  A . OP  AX  CC  . I OPT  YP  , 

swim 

, 

A 1 1 CEL2V  t T OLS  R.SLOP.  IPMmu.FHA^LM.  I FFGv  « P G v • 1 FPft  NT  • 1 P P A LL  * 

* IZONEP $ ISELCT#SELMIN  .3ELMAX, I 5LM IN , I SL MAX • IRAPUT.  IDCPUT.  {SORT. 
A I ORDER.  ISRTPR,  IPRBEG.  IPREnO.  ICCUNT.NBINS  .ZEPC.SCALE.  IF HI  ST  . 

j awwl r iu 
35001715 
3500  1 72  0 

/ 

* ITYPLT,  IFLTVfi . ICORR A,  ICCRRB.  IC ROEG • I CR PL T 
0 I MENS  ICN  1 ZONE  P ( 100) 

r |M.n^[r'YAT  t IT  v<-  ,^o  iNPf  t S c I NO  r » no  a*  c a t 

35001725 
3 5001730 

1.^00  \ 7 *M 

* CP  AX  DC  . IOPTYP .RANGE . COELEV. TCLER . SLOP . IFMAG. 

* FMAGLM.  IFFCV.FOy* [FPRnT . IF  PALL  . I ZONEP . 1 SEL CT *S ELM  I N . 

35001732 

35001733 

4 S G L M A X « I*.L  Y ( N i I ? L M A X * I R APUT  » 1 DC  PUT  * 1 50  R T .ICRCffW. 

* ISRTPR.  IPRBEG.  IPRENO.  I COUNT . NB IN S . ZERO  .SCALE. 

* I FH I ST  , ITYPLT. IPLTVR.ICORRA.  I C CR  RB  • ICRCEG*  ICRPLT 

3 ^0  v l > 34 
35001735 
35001 736 

c 

NR ITE  ( 16.1) 

PRIMARY  CONTROL  WORD 
I STATED 

3500 1900 
35001902 

c 

SECONDARY  CONTROL  WORCS  FOR  SUBROUTINE  STCATL 
C TYCA  T= 1 

35001905 

35001906 

S P I NR  A — C.  0 
SP INDC  = 0 .0 

qpaxra  = o .0 

35  00 1909 

35001912 

35001915 

OPAXOC -0 .0 
l OPTYP=  1 ^ 

35001919 
3500 1921 
3S00  l 92  a 

C CELE  V = 0 . C 
Toler  * i .0 

35001927 
3500 1930 

c 

«jL3P— 3 *P 
IFMAu=C 

r MA  GLM  =9 . 9E * t 0 
I FFOV=0 
F CV= 1 3f  .0 

SECCNCARY  CONTROL  WORCS  FCH  SUBROUTINE  STLIST 
I FPRNT  = l 
IFPALL=1 

— 390  019  T3 

35001936 
35001939 
35001942  * 

J 500 1 94  5 
3500194.7 
35001949 
35001951 

c 

DO  33  3 J J J- 1.1C0 
333  IZONEPi J JJ )=0 

SECCNCARY  CONTROL  WORDS  FOR  SUBROUTINE  ST SL CT 
I SELCT=0 
SLLMl N = C . 0 
SELMA  X = 0.0 

I SL  M I N = D 

l slmax=o 

35001954 

35001957 
35001959 
35001 960 
35001963 
3 5001966 
35001969 
35001972 

c 

c 

StCCNCANY  CONTROL  WORDS  POP  3LBPQUT  rN£ — ST  ALCL  ” — " 

I kAPU"= 7 
I CCPJTrd 

secondary  control  woroS  fur  subroutine  stpick 

I SORT  =0 
l ORDER = i 
I CRTPR  =0 
t PR BEG  = 1 ^ 

35001 974 

35001975 

35001979 

JS001980 

35001981 

3 50  019 8-A  „ .. 

35001987 

35001990 

c 

c 

SECONDARY  control  words  for  subroutine  STCONT 

I COUNT =C 

Ndl NS=  ic 
Z ER  C = C .0 

SCALE  = 3.0 

I FH I S T = r 

SECCNCARY  CONTROL  *CR05  FOR  SUBROUTINE  STPLCT 

3500  t 993 
35001995 
35001996 
35001999 
3500200 2 
-3  5002005 
35002008 
35002010 

c 

1 TYPE T s t 

i pltvr=o 

SECCNCARY  CONTROL  WOROS  FOR  SUBROUTINE  STCCRR 

3 500  201  4 
35002016 

Figure  9-4.  Places  Where  Source  for  STATS  Is  Modified  To 
Convert  It  to  a Main  Routine  (1  of  2) 
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ICc 
r 


IC0FRA=C 
I CORR0=C 
ILRQLG^O 
I CR PL  T = 0 
CONTINUE 


FORMAT ( * 1 ST  AT  1 5T I IS  MODULE  cNTcKcU'  ) 
RcAD(  I5.STAT  ,£ND  = 109) 

IrilR  m a tXJ  L) 


35002017 
J 50  02  02  0 
3 500  202  3 - 
35002026 
35002029 


3 500  21 0 0 
35002300 
3 5002*0.0. 


. .2 

1C  l 
IC2 


i F ( I ST AT  « £ C *0 ) RETURN 

GO  TO  < KM  * IT  2,  l -U,  104  ♦ 1 C5*  IC6,  10  7.  103,  109  ) * I ST  AT 

CALL  STL  l ST  ( LST3A^r-F3TQ^T^N£H*W*£H-M2-.NLM€-A-T-) 

GO  TO  IOC 

CALL  5TCATL(0  • I 370 A T , F STD A T *S TLGNG • NC I M 1 • NC I M 2 . NUMC AT  ) 


GO  TO — VXPT 

CALL  STSLCTt  I STOAT • FSTC AT  «N C 1 * 1 « NO 1 *2. NUMC AT) 

GU  TO  l'.O  _ 

CALL  3TRES  T(  I STOAT  ♦ FSfb  A T • ST'LonG  • NO  I M l , NO  I M 2 • * C AT  ) 

GO  TC  103 

CALL-  STALCL  i I STOAT  ^F  ST  0-4T  MS  » NUMC  A-T  ^ - — 

GC  TO  IOC 

CALL  3TPICK(I S^oaT.  =STCAT  . NO I V l * NO l M 2 . N UMC AT ) 


35002500 

35002600 

J M V U f W 


35002300 

35002900 

35003000 

25003100 

35003200 


103 
l C 4 
1C5 
10  6 
107 
1 Co 
ICC 
19* 


g a to  rcr 

CALL  STCCNTt  I STOAT. f STD  AT, NO I VI  * N D I V2 . NUMC AT) 
GO  TO  ICO  _ 


35003300 

35003400 

3 gap  -»cLrt  m 

U V V W V \J 


35003600 

35003700 

35003500 

35003900 

35004000 


CALL  S TPLC7 ( I 5T0 A” * F STD AT .5TLCNG.N0  I M 1 . NO  1 M 2 . NU VC AT ) 
GD  TO  ICO 

CALL  STCCR^U  STOAT-*? 

GU  TO  l v.  O 

write i ie.: ) 


:rnRMATr 


25004100 

35004200 

-36004300 


35004400 

35004500 


ENQ_ 


35004700 1 


1-  - DELETE  THIS  STATEMENT. 

2.  - DELETE  THIS  CARD  AND  INSERTTHE  FOLLOWING  {ALL  BEGIN  IN  COLUMN  7): 


DIMENSION  ISTDATCAAAA),FSTDATCAAAA,B),STLONGCAAAA) 
I FDG  = U 
I DFL  = VV 

15  = XX 

16  = YY 
INFILE  = ZZ 
NDIMl  = AAAA 
NDIM2  = B 
CALL  INITSK 


WHERE  XX,  YY  AND  ZZ  ARE  THE  REFERENCE  NUMBERS  FOR  THE  CONTROL  INPUT 
DATA  SET,  PRINTED  OUTPUT  DATA  SET  AND  RUN  CATALOG  DATA  SET,  RESPEC- 
TIVELY, u is  the  Diagnostic  level  flag  (see  section  8 5 2)  vv  is  the 

DIAGNOSTIC  OUTPUT  FILE  NUMBER  (U  = 0 ONLY)  AAAA  IS  THE  MAXIMUM 
NUMBER  OF  CORE  CATALOG  STARS  EXPECTED,  AND  B IS  THE  NUMBER  OF 
FLOATING  POINT  WORDS  OF  DATA  PER  STAR 

3.  - REPLACE  THIS  STATEMENT  WITH  THE  FOLLOWING, 


ST  OF 

Figure  9-4.  Places  Where  Source  for  STATS  Is  Modified  To 
Convert  It  to  a Main  Routine  C-  of  2} 
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ORIGINAL  PAGE  !S 
OF  POOR  QUALITY 


Figure  9-3  gave  the  NAMELIST  input  used.  Each  complete  NAMELIST  is 
delineated  with  a heavy  horizontal  line  and  assigned  a reference  letter  (on  the 
right) . 

The  following  table  interprets  these  sample  NAMELISTs  in  words.  Figures  9-5a 
to  9-24a  present  the  resultant  printed  output  for  a Run  Catalog  generated  by  the 
SKYMAP  system  to  a limiting  magnitude  of  7.  6. 

Subroutine  Called 

Reference  Due  to  Secondary  Control 

Letter  Primary  Control  Card  Meaning 


A 

B 

C 


D 


E 

F 


G 

H 

I 

J 


ST  LIST 
ST  LIST 
STLIST 

STCATL 

STPICK 

STSLCT 

STPICK 

STREST 

STPICK 

STALDL 


List  header,  row,  definition  and 
printer  arrays 

Also  list  zone  definition  param- 
eter. List  data  for  all  zones 

Also  list  star  data.  List  only 
those  zones  specified  (num- 
bers 2,  3,  and  5) 

Generate  a Core  Catalog  using 
subroutine  FETCH.  The  opti- 
cal axis  right  ascension  and 
declination  are  180  degrees 
and  30  degrees,  respectively 

Do  not  sort.  List  all  eight  data 
words 

Pick  out  all  stars  with  FSTDAT 
(*,  4)  between  -9.999  x 10^ 
and  5 . 0 

Do  not  sort.  List  all  eight  data 
words 

Reset  catalog  as  it  was  before 
STSLCT 

Do  not  sort.  List  all  eight  data 
words 

Calculate  star  right  ascensions 
and  declinations.  Store  in 
FSTDAT  7i  and  FSTDAT 
i*.  3),  respectrelv 
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Reference 

Letter 

K 

L 

M 

N 

O 

P 

Q 

R 

s 

T 

U 

V 

W 


original  rage  is 

OF  POOR  QUALITY 


Subroutine  Called 

Due  to  Secondary  Control 

Primary  Control  Card  Meaning 


ST  PICK 
STPICK 

ST  PICK 


STCONT 

STCONT 


STCONT 


STPLOT 

STPLOT 


STCORR 


STCORR 


STSLCT 

STPICK 


Do  not  sort.  List  all  eight  data  words 

Sort  Core  Catalog  on  FSTDAT  (*,  4). 
Sort  in  ascending  order.  List  data 
for  all  stars 

Sort  Core  Catalog  on  ISTDAT.  Sort 
in  descending  order.  List  only  the 
3rd  through  28th  positions  in  the  Core 
Catalog  arrays 

Count  the  stars  in  reference  to 
FSTDAT  (*,  4).  Count  into  10  bins 
(automatic  scaling) 

Count  the  stars  in  reference  to 
FSTDAT  (*,  4).  Define  the  bins  to 
have  a zero  of  3. 2 and  a scale  factor 
of  1.0.  Produce  a histogram  of  the 
results 

Count  the  stars  in  reference  to 
FSTDAT  (*,  4).  Count  into  50  bins 
(automatic  scaling) 

Plot  the  Core  Catalog  on  full-sky  plot 

Plot  the  Core  Catalog  on  an  amplified 
sky  scale.  The  symbol  is  defined  in 
reference  to  FSTDAT  (*,  4) 

Correlate  FSTDAT  (*,  3)  against 
FSTDAT  (*,  8).  Use  a linear  fit.  Do 
not  plot  the  results 

Correlate  FSTDAT  (*,  3)  against 
FSTDAT  (*,  8).  Use  a quadratic  fit. 
Plot  the  results 

Select  all  stars  with  FSTDAT  (*,  3) 
between  0.  0 and  0.  5 

Do  not  sort.  List  all  eight  data  words 

Return  to  calling  routine 
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Figure  9-5.  Statistics  Module  Output  for  NAMELIST  A (2  of  3) 
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Figure  9-fi.  Statistics  Module  Output  for  NAMELIST  B (1  of  5) 
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Figure  9-(>.  Statistics  Module  Output  for  NAMELIST  B (3  of  5) 
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Figure  9-G.  Statistics  Module  Output  for  NAMELIST  B (5  of 
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Figure  9-7.  Statistics  Module  Output  tor  NAMELIST  C (2  of  6) 
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Figure  9-7.  Statistics  Module  Output  for  NAMELIST  C (3  of  G) 
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Kiffure  9-7.  Statistics  Module  Output  for  Figure  9-7.  Statistics  Module  Output  for 

NAMELIST  C (1  of  (!)  NAMELIST  C (5  of  6) 
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Figure  9-7.  Statistics  Module  Output  for  NAMELIST  C (6  of  6) 
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Figure  9-9.  Statistics  Module  Output  for  NAMELIST  E 
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9-10.  Statistics  Module  Output 
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Figure  9-11.  Statistics  Module  Output  for  NAMELIST  G 
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Figui'e  9-12. 
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Figure  9-13.  Statistics  Module  Output  for  NAMELIST  I 
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Figure  9-15.  Statistics  Module  Output  for  NAMELIST  K 
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Figure  9-lfi.  Statistics  Module  Output  for  NAMFLIST  L 
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Figure  9-18.  Statistics  Module  Output  for  NAMELIST  N 
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Figure  9-20.  Statistics  Module  Output  for  NAMELIST  P 
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Figure  9-21.  Statistics  Module  Output  for  NAMELIST  Q 
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Figure  9-22.  Statistics  Module  Output  for  NAME  FIST  It 
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Figure  9-24 . Statistics  Module  Output  for  NAMELIST  T (2  of  2) 
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9.6.3  Job  Control  Language 

The  Statistics  Module  subroutines  may  be  incorporated  into  any  desired  pro- 
gram. To  run  them,  define  FORTRAN  data  sets  for  the  following  reference 
numbers  in  the  GO  step:  15,  16,  IPLTFL,  INFILE. 

15  is  used  for  NAMELIST  input;  16  is  for  printed  output;  IPLTFL,  for  printer 
plot  output;  and  INFILE  for  the  input  direct-access  Run  Catalog.  If  diagnostic 
output  is  to  be  generated  (IFDG  ^ 0),  a FORTRAN  data  set  for  reference  number 
IDFL  must  also  be  defined.  Table  9-4  gives  the  DCB  characteristics  required 
of  each  data  set. 

The  source  code  for  LOOKAT  and  nonexecutable  object  module  members  are 
available.  Names  and  locations  of  these  data  sets  are  available  from  the  atti- 
tude determination  program  maintenance  functional  group  of  GSFC,  code  581. 

9.6.4  Overlay  Considerations 

The  Statistics  Module  subroutines  may  be  placed,  as  a unit,  in  an  overlay 
structure.  Within  the  Statistics  Module,  any  subroutine  may  be  overlaid  as  a 
separate  unit  with  these  restrictions: 

• STLIST  and  PZONE  must  be  in  the  same  unit. 

• STPLOT,  PLOT,  and  GENPLT  must  be  in  the  same  unit. 

• STATS  and  GITOAD  and  COMMON/STINST/  must  be  in  the  root. 

• STCATL  and  STREST  require  Access  Module  subroutines.  The 
Access  Module  subroutines  have  overlay  considerations  as  given 
in  Section  8. 6.4.  No  additional  restrictions  are  posed  by  STCATL 
and  STREST,  which  may  be  overlaid  separately  from  the  Access 
Module  subroutines  they  reference. 
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Table  9-2.  DCB  for  Statistics  Module  Data  Sets 


DATA  SET 
REFERENCE 
NUMBER 

8LOCKING 

LOGICAL 

RECORD 

LENGTH 

BLOCKSIZE 

15 

FB 

80 

7280 

I61 

VBA 

137 

1922 

IPLTFL1 

VBA 

137 

1922 

(NFILE 

F3  ! 

1640 

1640 

IDFL1 

VBA 

137  | 

1922 

’these  ARE  NORMALLY  SYSOUT  = A DATA  SETS. 
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9.6.5  System  Resources  Needed 
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The  Statistics  Module  subroutines  core  storage  requirements  are  given  in  the 
following  table: 


Subroutine 

GENPLT 

PLOT 

PZONE 

STALDL 

STATS 

STCATL 

STCONT 

STCORR 

STLIST 

STPICK 

STPLOT 

STREST 

STS  LOT 


Size  (Bytes) 

11836 

9250 

4336 

934 

1888 

2260 

3682 

11194 

3892 

2102 

640 

466 

1062 


Larger  storage  requirements  that  these  are  imposed  by  the  Access  Module  sub- 
routines referenced  by  the  Statistics  Module  (see  Section  8.  6.  5). 

9.6.6  Execution  Time  Estimates 

Because  of  the  large  variety  of  functions  performed  by  the  Statistics  Module,  we 
have  not  attempted  to  estimate  execution  times. 
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APPENDIX  A - B-V  ANb  U-B  VERSUS  DISTANCE  PLOTS 


This  appendix  is  published  separately. 
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APPENDIX  B - COLOR  EXCESS  VERSUS  DISTANCE  PLOTS 


This  appendix  is  published  separately. 


APPENDIX  C - FORTRAN  COMPILER  LISTING  OF 
PROGRAM  UPDATE 

This  appendix  is  published  separately. 
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APPENDIX  D - FORTRAN  COMPILER  LISTING  OF 
PROGRAM  CAT 

This  appendix  is  published  separately. 
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APPENDIX  E - FORTRAN  COMPILER  LISTING  OF 
PROGRAM  SWITCH 


This  appendix  is  published  separately. 
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APPENDIX  F - ZONE  SELECTION  TECHNIQUES 

This  appendix  contains  a mathematical  proof  that  the  techniques  for  selecting 
the  zones  that  subroutine  STORE  reads  to  generate  a Core  Catalog  (Section  8. 3) 
will  always  contain  all  Run  Catalog  stars  within  the  specified  region  of  the  sky. 

Because  several  different  techniques  are  used  for  zone  selection,  the  proof  is 
divided  into  three  cases.  Before  these  are  discussed,  however,  two  theorems 
that  will  be  used  repeatedly  will  be  proved. 

• Definition:  Let  X and  Y be  any  points  on  the  unit  sphere.  d(X,  Y) 
is  defined  as  the  smallest  angular  distance  between  X and  Y along  a great 
circle.  d(X,  Y)  is  always  taken  as  positive. 

• Theorem  1:  If  X , Y , and  Z are  three  points  on  the  unit  sphere, 
such  that  d(X,  Y)  , d(X,  Z)  , and  d(Y,  Z)  are  each  £90  degrees,  then 

d(X,  Y)  + d(Y,  Z)  £ d(X,  Z) 

• Proof:  This  is  a formulation  of  the  Schwartz  inequality.  Let  XYZ 
be  the  spherical  triangle  defined  by  points  X , Y , and  Z ; let  £ be  the  angle 
opposite  side  XZ  . 

Then,  by  the  law  of  cosines 


cos  [d(X,  Z)2  = cos  "d(X,  Y)J  cos  [dCY,  Z)j 

- sin  Cd(X,  Y)I  sin  [d(Y,  Z)2  cos  £ 


(F-l) 


Since  cos  £ a -1  for  any  value  of  £ , Equation  (F-l)  becomes: 

cos  [d(X,  Z)'  a cos  Id(X,  Y)]  cos  [d(Y,  Z)] 

- sin  [d(X,  Y)I  sin  fd(Y,  Z)\ 


(F-2) 


F-l 
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Thus, 


cos  [d(X,  Z)2  * cos  [d(X,  Y)  + d(Y,  Z)Z  (F-3) 

Since  0 degree  £ d(X,  Z)  £ 180  degrees  , and  0 degree  £ d(X,  Y)  + d(Y,  Z)  £ 
180  degrees  , Equation  (F-3)  implies 

d(X,  Z)  2 d(X,  Y)  + d(Y,  Z)  (F-4) 

• Definition:  For  any  given  point  on  the  unit  sphere,  such  as  an  op- 
tical axis  pointing,  subroutine  ZONES  selects  one  zone  for  subroutine  STORE 
to  read.  This  is  called  the  selected  zone. 

Zones  are  defined  by  program  CAT  as  the  area  between  two  pairs  of  parallel 
circles  on  the  unit  sphere  (see  Section  6.  3.2).  One  pair  of  circles  are  great 
circles  (called  right  ascension),  which  intersect  at  the  poles  of  the  unit  sphere. 
The  other  pair  (called  declination)  are  parallel  to  the  equator  of  the  unit  sphere. 
The  zone  height  is  the  distance  between  the  two  declination  circles.  The  zone 
width'*’  was  computed  to  be  greater  than  or  equal  to  the  minimum  distance  be- 
tween the  circles  of  right  ascension  for  any  declination  between  the  two  decli- 
nation circles  (see  Figure  F-l). 

Therefore,  the  zone  width  is  greater  than  or  equal  to  W/cos  6’  where  W is 
the  zone  height  and  £'  is  the  declination  within  the  zone  of  largest  absolute 
value.  Mathematically,  a pointing  in  the  zone  provided  that 


W 


I a - a ; ^ 0 
c o 2 cos  o' 


16-6 
1 c o 


£ 


w 

2 


(F-5) 


By  ‘'zone”  we  refer  to  a combination  of  two  adjacent  half-zones  sc  as  to  create 
a "whole"  zone  meeting  this  requirement. 


F-2 
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Figure  F-l.  Definition  of  Zone  Limits 
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where  (a  , 6 ) are  the  right  ascension  and  declination  of  the  zone  center  and 
c c 

(a  , 6 ) are  the  right  ascension  and  declination  of  the  pointing, 
o o 

Because  zones  overlap  by  50  percent  on  all  sides  (Figure  6-2),  the  selected 
zone  for  a given  pointing  is  computed  by  LOOKAT  as  the  one  which  satisfies 

, . W 

a -a  cos  6 ^ — 
o c o 4 


and 


(F-6) 


6 

o 


W 

4 


In  Figure  F-l,  the  dotted  lines  enclose  the  region  of  the  sky  in  which  a pointing 
will  cause  the  zone  to  be  selected. 

o Theorem  2:  If  a pointing  X causes  a zone  to  be  selected,  all 
points  Y such  that  d(X,  Y)  ^ w/4  will  lie  within  the  selected  zone. 

o Proof:  Let  (a  , 6 ) be  the  right  ascension  and  declination  of  the 

X X 

pointing  X . Let  (a  , 6 ) be  the  right  ascension  and  declination  of  the  center 

c c 

of  the  zone  (C)  selected  for  X . Let  (a^,  6 ) be  the  right  ascension  and  dec- 
lination of  any  pointing  Y such  that  d(x,  y)  ^ W/4  . '.Ve  must  prove  that  Y is 
in  Zone  C. 

First, 


a 


y 


+ a 

x 


a [ s la  - a 1 + la 

c 1 y x 1 1 x 


(F-7) 
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Similarly, 


Is  - el  £ Is  - s i + |s  - 5 I 

1 y c 1 y x x c 


(F-8) 


Using  Equation  (F-6),  Equations  (F-7)  and  (F-8)  become 


i , W E -1  | i 

i a -a  ! ^ — (cos  6 ) + a - ci  \ 

1 y c 4 ' x y x 


1 6 - 6 ! s-y  + |6  - 5 | 
y c 4 y x 


(F-9) 


Let  P be  the  point  at  right  ascension  a and  declination  5 . 

y x 

Then 


d(P,  Y)  = 


I 6 - 6 

y x 


and 


(F-10) 


d(P,  X)  = | a - a 
y x 


cos  6 

x 


But  PXY  is  a right  spherical  triangle;  hence 


d(P,  Y)  £ d(X,  Y) 


and 


(F-ll'i 


d(P,  X)  £ d(X,  Y) 
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By  assumption,  d(X,  Y)  ^ W/4  ; therefore, 


W 

d(P,  Y)  * — 


and 


(F-12) 


d(P,  X)  * j 

Combining  Equations  (F-10)  and  (F-12) 


a 

y 


! ^ c W 

a ^ cos  6 — 
x x 4 


(F-13) 


Substituting  this  result  in  Equation  (F-9),  and  noting  that  cos  6^  is  always 
positive  since  -n/2  ^ 6^  ^n/2  : 


a 

y 


„ w , c ,-i  w . c . w 

s — (cos  6x)  +T(cos6x) 


X 


W 

2 cos  6' 


(F-14) 


16-6 
y c 


w w w 

4 + 4 2 


where  6'  is  the  declination  of  greatest  absolute  value  within  the  zone.  Equa- 
tion (F-14)  is  precisely  the  condition  stated  in  Equation  (F-5)  for  a pointing  be- 
ing within  the  zone. 

We  now  are  ready  to  prove  that  each  of  LOOKAT's  zone  selection  techniques 
selects  the  zones  necessary  to  create  a Core  Catalog  containing  all  stars  within 
the  specified  region  of  the  sky. 
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o Definition:  F = the  half-cone  angle  of  a circular  field  of  view  or  the 
half-side  length  of  a square  field  of  view,  c = an  error  allowance  (LOOKAT 
NAMELIST  parameter  SLOP),  which  is  added  to  F to  determine  the  desired 
height  of  a band  or  wedge  Core  Catalog,  r = the  angular  distance  between  com- 
puted optical  axis  pointings  (LOOKAT  NAMELIST  parameter  TOLER;  see  Sec- 
tion 8. 3.  4). 

• Case  I:  For  a cap  Core  Catalog  when  F £ W/4  , there  is  only  one 
selected  zone — the  one  for  the  user-defined  optical  axis.  By  theorem  2,  all 
stars  within  W/4  degrees  of  this  pointing  are  in  the  selected  zone.  Therefore, 
the  selected  zone  is  the  only  one  required  to  ensure  that  all  Run  Catalog  stars 
within  the  cap  are  in  a selected  zone. 

• Case  II:  For  a band  catalog  when 

W 

FAe  + fs-  . (F-15) 


the  Core  Catalog  must  contain  all  stars  within  (F  + e)  of  the  path  taken  by  the 
optical  axis  during  one  rotation  about  the  spin  axis. 

For  a wedge  catalog  for  which  the  condition  of  Equation  (F-15)  is  met,  the  Core 
Catalog  must  contain  a subset  of  those  stars  in  the  band  defined  by  longitude 
limits  (see  Section  8. 3.  5).  In  this  appendix,  it  is  assumed  that  the  longitude 
selection  is  done  properly,  and  only  the  question  of  proper  selection  of  zones 
for  that  band  of  which  the  wedge  is  a subset  is  addressed. 

When  the  condition  of  Equation  (F-15)  is  met,  LOOKAT  creates  a series  of  op- 
tical  axis  pointings  (see  Section  8.  3.4),  la.  , 0.  1 , i = 1,  N where  I , t>.  j 
are  the  right  ascension  and  declination  of  the  ith  pointing,  and  N°  is  the  num- 
ber of  pointings. 
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The  pointings  are  created  such  that 


and 


(4 


^ T 


i = 1; 


N 


- 1 


(F-16) 


£ r 


It  is  now  to  be  demonstrated  that  any  star  within  the  band  of  height  2(F  + €) 
centered  on  the  optical  axis  path  is  in  the  zone  selected  for  |a°,  6°j  for 
some  i . 

• Proof:  Figure  F-2  depicts  the  situation.  Y is  any  arbitrary  point 
(star)  in  the  band  defined  above.  The  arc  YZ  is  constructed  perpendicular  to 
the  optical  axis  path  and  along  a great  circle.  Let  the  computed  optical  axis 
points  on  either  side  of  Z have  right  ascension  and  declination  5°  j and 
(a° , 6°  ) , respectively.  Call  the  points  O and  O . From  Theorem  1 


d(Y,  Ok)  ^ d(Y,  Z)  + d(Z,  Ok) 


(F— 17) 


Because  YZ  is  an  arc  of  a great  circle  perpendicular  to  the  optical  axis  path. 


d(Y,  Z)  ^ F + e 


(F-18) 


Because  Z is  intermediate  to  O and  O , and  lies  on  :he  same  circle  as 

k k+1 

these  two  points. 


d(Ok,  Z)  , d(Ok,  ok+1) 


(F-19) 


F-8 
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X = OPTICAL  AXIS  POINTINGS 
CREATED  BY  LOOKAT 


OPTICAL  AXIS 
PATH 


Figure  F-2.  Schematic  Representation  of  Case  II 
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By  Equation  (F-16),  d(0  , O ) £ t , so 

K K * J. 

d(Ok,  Z )st  (F-20) 

Substituting  Equations  (F-18)  and  (F-20)  in  Equation  (F-17) 

d(Y,  O ) £ F + c + r 


Using  Equation  (F-15) 


d(Y,  Ok)  * — (F-21) 

Because  O is  one  of  the  optical  axis  points  computed  by  LOOKAT,  the  zone 

for  O is  selected.  By  theorem  2,  Equation  (F-21)  implies  that  Y is  in  that 
& 

zone.  Hence,  Y is  in  one  of  the  zones  selected,  namely  that  for  pointing  O,  . 

K. 

• Case  III:  For  a band  catalog  with  F + e + r > W/4  , the  Core  Cata- 
log must  contain  all  stars  within  (F  + c)  of  the  path  taken  during  one  rotation 
about  the  spin  axis.  For  a similar  wedge  catalog,  a subset  of  these  stars  is 
required,  as  for  Case  II. 

In  addition,  a cap  catalog  with  F > W/4  is  treated  by  LOOKAT  in  the  same 
way,  with  e = 0 and  T set  by  LOOKAT.  The  coelevation  angle  is  taken  as 
0.0,  thus  effectively  placing  the  optical  axis  at  the  center  of  the  cap. 

The  technique  used  by  LOOKAT  to  select  zones  in  this  case  is  the  same  tech- 
nique used  for  Case  II,  except  that  additional  sweeps  are  taken  along  circles 
parallel  to  the  optical  axis  path  and  located  at  distances  io  , =20  , . . . , 
inq  , ±ip  from  the  optical  axis  path,  with  [jp  - nol  • 
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e Proof:  Call  the  sweeps  at  ±ip  from  the  optical  axis  path  the  "final 
sweeps."  Let  Y be  an  arbitrary  point  (star)  lying  within  (F  + e)  of  the  op- 
tical axis  path.  It  must  be  proved  that  Y lies  within  one  of  the  selected  zones. 

e Case  Ilia:  Y lies  inside  the  final  sweeps.  Figure  F-3  depicts  the 
situation.  The  arc  Z.Z  is  a part  of  a great  circle  perpendicular  to  the  cir- 

-i  m 

cles  shown  and  passing  through  point  Y . , 09  , , and  are  the  four 

optical  axis  points  created  by  LOOKAT  surrounding  Z^  and  Z9  . 

Note  that  d(Z^,  Z^)  ^ <p  . 

Because  Y , and  Z^  lie  on  the  same  great  circle 

d(Y,  Zx)  + d(Y,  Z2)  =d(Z1,  Zg)  * <p  (F-22) 


Therefore,  either 


d(Y.  Zj)*! 


or 


(F-23) 


d(Y,  Z2)*f 

Without  loss  of  generality,  let  d(Y,  Z^)  £o/2  . 

By  Equation  (F-16), 

d(0L,  02)sr  ( F— 24) 


F-ll 
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Because  O , Z , and  O lie  on  a circle,  either 

11  Z 


d(0l'  Zl>  2 


or 


d(°2  ’ Zl) 

Without  loss  of  generality,  let  d(0^,  Z^)  st/2  . 
Combining  Equations  (F-23)  and  (F-25)  and  theorem  1, 


d(Y,  Ox)  *d(Y,  Zx)  +d(01,  Zx) 


If  the  restriction  is  imposed  that 


then,  using  Equations  (F-26)  and  (F-27), 


W 

d(Y,  OJ  * — 


(F-25) 


(F-26) 


(F-27) 


(F-28) 
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By  theorem  2,  Y lies  in  the  selected  zone  for  provided  Equation  (F-27)  is 
satisfied.  Rewriting  Equation  (F-27), 
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quality 


(F-29) 


In  LOOKAT,  o = (W/2)  - T . 

Hence,  Equation  (F-28)  holds. 

e Case  mb:  Y lies  outside  the  final  sweeps.  Figure  F-4  depicts 

the  situation.  The  arc  YZ  is  part  of  a great  circle  perpendicular  to  the  circles 

shown  and  passing  through  Y . O and  O are  the  optical  axis  points  sur- 

1 z 

rounding  Z . Note  that 

d(Y,  Z)  £ X - (>P  ~ ncp)  (F-30) 

l 

Also,  by  Equation  (F-16) 


d(01»  02)  ^ r 

and  since  O , Z , and  O lie  on  a circle,  either 

L Z 

d(Olt  Z)*| 


or 


(F-31) 


d(°2.  Z)*f 

Without  loss  of  generality,  let  dfO^,  Z)  £ r/2  . 


F-14 


ORIGINAL  PAGE  13 

OF  POOR  QUALITY 


EDGE  OF 

DESIRED  FINAL 


Figure  F-4.  Schematic  Representation  of  Case  nib 
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By  theorem  1, 


d(Y,  Ox)  £d(Y,  Z)  + d(0^,  Z) 
Substituting  the  results  of  Equations  (F-30)  and  (F-31), 

d(Y,  Ox)  - (^-  n<p)  +j 


Therefore,  provided  that 


X - # - n<p)  + \ * 


W 

4 


. ^ W 

d(Y»  Ox)  * — 


which  by  theorem  2 proves  that  Y is  in  the  selected  zone  for  O . 
Equation  (F-34),  X - (ip  - nc p)  ^ (W/4)  - (t/2)  . 

In  LOOKAT,  X - (>P  - n<p)  = (W/4)  - (t/2)  ; hence,  Equation  (F-34)  is 
and  Equation  (F-35)  holds. 

All  cases  have  now  been  covered  and  the  proof  is  complete. 


(F-32) 

(F-33) 

(F-34) 

(F-35) 

Rewriting 

satisfied 
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ABSTRACT 


The  SKYMAP  Master  Catalog  nearest-neighbor  parameters  are  being  revised 
in  accordance  with  the  results  of  this  study  on  the  accuracy  of  multiple  star 
separations.  Additional  parameters  are  being  added  of  the  form:  "nearest 
neighboring  star  more  than  X arc-seconds  distant, " where  X takes  on  discreet 
values  from  2 to  300. 


SECTION  1 - INTRODUCTION 


The  distance  between  a star  and  its  nearest  neighboring  star  (at  some  magnitude 
limit)  can  be  an  important  parameter  for  star  identification  and  attitude  deter- 
mination algorithms.  Such  algorithms  may  exclude  an  identification  from  atti- 
tude computation  if  the  catalog  star  has  a neighbor  within  the  identification 
error  window  (possible  misidentifi cation).  The  SKYMAP  Master  Catalog  has 
the  distance  to  the  nearest  neighboring  Master  Catalog  star  as  one  of  its  data 
words  (Reference  1). 

For  some  applications,  stars  separated  by  less  than  some  given  angular  dis- 
tance may  be  acceptable  for  attitude  computation.  For  example,  if  the  required 
attitude  accuracy  is  1 arc-minute  it  makes  no  difference  which  of  two  stars 
(separated  by  5 arc-seconds)  the  sensor  actually  tracked.  Therefore,  the  Master 
Catalog  nearest-neighbor  data  words  have  been  recomputed  to  exclued  succes- 
sively larger  values  of  the  minimum  distance  a stap  must  be  from  a catalog 
star  to  be  considered  its  neighbor.  Specifically,  the  Master  Catalog  contains 
the  following  nearest-neighbor  data  words: 

• Nearest  neighbor  in  the  Master  Catalog,  including  members  of 
multiple  systems  (no  minimum  separation). 

• Nearest  neighbor  in  the  Master  Catalog,  including  members  of 

2 arc-seconds,  5 arc-seconds,  15  arc-seconds,  40  arc-seconds, 

120  arc-seconds,  or  300  arc-seconds. 

The  choice  of  2 arc-seconds  as  the  smallest  separation  is  based  on  an  analysis 
of  the  accuracy  of  the  known  star  positions  and  multiple  star  separation  ( see 
Secion  2). 

A near-neighbor  to  a star  may  be  another  star  that  is  physically  associated 
with  it  (members  of  a multiple  star  system)  or  a star  that  lies  in  nearly  the 


H - i-i 


same  direction  relative  to  the  Earth  (optical  double).  Both  possibilities  are 
considered  in  the  SKYMAP  nearest-neighbor  computation. 


SECTION  2 - ACCURACY  OF  THE  NEAREST-NEIGHBOR  PARAMETER 


The  accuracy  of  the  nearest-neighbor  computation  depends  on  the  following 
factors: 

• The  accuracy  of  Master  Catalog  star  positions  (for  optical  doubles 
only). 

• The  accuracy  of  Master  Catalog  multiple  star  separations  (Refer- 
ence 2)  for  physical  doubles  only. 

• The  motion  of  the  members  of  multiple  star  systems  relative  to 
one  another  since  the  time  of  measurement  of  their  separation. 

Over  90  percent  of  Master  Catalog  stars  have  positions  from  the  Smithsonian 
Astrophysical  Observatory  (SAO)  catalog  (Reference  3).  These  positions  are 
accurate  to  < .1  arc-second  (one  standard  deviation) . The  multiple  star  separa- 
tions are  believed  to  be  as  accurate  at  the  epoch  of  their  observation. 

The  third  factor  listed  above  as  contributing  to  the  error  remains  to  be  eval- 
uated. To  do  so,  a model  of  the  relative  motion  of  members  of  multiple  star 
systems  has  been  developed  to  yield  the  distribution  of  angular  separations  of 
two  multiple  star  members  as  a function  of  the  interval  since  measurement  of 
the  separation,  and  as  a function  of  the  angular  separation  at  the  time. 

The  basic  parameters  of  the  model  are  presented  in  Figures  2-1  and  2-2.  Fig- 
ure 2-1  shows  the  relationship  of  the  distance  to  the  star  (Z),  its  angular  separa^ 
tion  (0)  and  its  physical  separation  (r)  . The  two  stars  orbit  their  common 
center-of-mass,  but  we  simplify  the  problem  by  referencing  our  calculations 
to  the  primary. 

Figure  2-2  shows  the  relationship  of  the  orbital  radius  (r)  assuming  a circular 
orbit,  the  angular  separation  (0)  at  phase  (0)  on  the  orbit,  and  the  maximum 
angular  separation  (®max  » at  phase  0°). 
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Figure  2-1.  Physical  and  Angular  Separation  for  a Star 
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Considering  first  the  component  of  separation  in  the  horizontal  direction  (H)  in 

' ^ 

Figure  2-2,  then  the  component  of  separation  in  the  vertical  direction  (V),  and 
finally  summing  them  (using  the  square  root  of  the  sum  of  the  squares  since  the 
great  distance  to  the  stars  allows  planar  treatment  of  the  problem) 


0 

max 


/ 2 ! 2 9 

V cos  0 + sin  0 sin*"  i 


(2-1) 


where  i is  the  inclination  of  the  orbital  plane  to  the  Earth-star  line. 
When  the  star  is  at  maximum  separation,  the  orbital  radius  is  given  by: 


r = 


IB 


max 


(2-2) 


where  0 is  in  radians, 
max 

To  address  the  problem  of  how  much  the  angular  separation  changes  in  a given 
time  interval,  T,  let  0 be  the  phase  at  the  beginning  of  the  interval,  and  t ^ 
the  phase  at  the  end  of  the  interval. 

Thus, 


02  — 0X  = T/P 


(2-3) 


where  P is  the  orbital  period. 

Using  Equation  (2-1)  to  compute  0 and  0 , the  angular  separations  at  these 
two  phases, 


2 2 2 
^cos  0 + sin  0_  sin 

0„  2 ■ 2 -B 


-) 


cos^  0 + sin^  0,  sin^  i 


(2-4) 


By  Kepler's  law, 
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P = 


(2-5) 


where  P is  the  period  and  K is  a constant.  K = 1 if  P is  written  in  years 
and  r in  astronomical  units  (the  mean  distance  from  the  Earth  to  the  Sun). 

Using  0^  as  the  phase  at  the  epoch  of  observation,  Equations  (2-1)  and  (2-5) 
yield: 


P 


3/2  3/2 

Ki  e1 


/ 2 2 2 \3/i 
(cos  0 + sin  0^  sin  i j 


(2-6) 


Equations  (2-3),  (2-4)  and  (2-6),.  taken  together,  can  be  used  to  evaluate  the  diS' 
tribution  of  6^  after  a period  of  T years . 

The  various  parameters  that  enter  with  computation  of  the  distribution  of  6 

Li 

are  defined  in  Table  2-1. 

The  approximation  has  been  made  that  the  distribution  of  distances,  i , for 
all  Master  Catalog  stars  (Table  2-2),  is  also  valid  for  multiple  stars.  Further, 
it  is  assumed  that  the  distribution  of  i is  equally  valid  for  all  observed  values 
of  the  separation,  0^  . Actually,  large  values  of  0^  generally  correspond 
to  relatively  nearby  stars.  However,  the  distribution  of  distances  shown  in 
Table  2-2  is  sufficiently  concentrated  (95  percent  of  the  stars  are  closer  then 
500  parsecs)  that  this  approximation  is  considered  satisfactory. 

The  distribution  of  0 has  been  obtained  by  integrating  Equation  (2-4)  with 

Li 

Equations  (2-3)  and  (2-6),  and  using  d.  , i , and  L as  variables  of  integration 
(see  Table  2-1).  The  results  are  presented  in  Table  2-3. 
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Table  2-1. 


Parameters  Needed  To  Evaluate 
the  Distribution  of  0 ^ 


PARAMETER 

HOW  OBTAINED 

T 

STUDY  PARAMETER  WITH  RESULTS  PRESENTED  AS  A FUNCTION  OF  T 

STUDY  PARAMETER  WITH  RESULTS  PRESENTED  AS  A FUNCTION  OF  6 , 

VARIABLE  OF  INTEGRATION  (VARIED  UNIFORMLY  BETWEEN  0°  AND  360°) 

i 

VARIABLE  OF  INTEGRATION  (VARIED  UNIFORMLY  BETWEEN  0°  AND  90°) 

K 

= 1 BECAUSE  P IS  WRITTEN  IN  PARSECS  AND  r IN  ASTRONOMICAL  UNITS 

G 

VARIABLE  OF  INTEGRATION  (DISTRIBUTION  GIVEN  IN  TABLE  2-2) 

*2 

EVALUATED  FROM  EQUATION  (2-3) 

P 

EVALUATED  FROM  EQUATION  (2-6) 

ORIGINAL  P^OE  J3 
OF  POOR  QUALtT* 


VT  ' 


Table  2-2.  Distribution  of  Distances 


DISTANCE  RANGE 
(PARSECS) 

NUMBER  IN 
MASTER  CATALOG 

FRACTION  OF 
TOTAL 

0-10 

258 

0.006 

10-20 

3433 

0.085 

20-30 

1266 

0.031 

30-40 

1314 

0.032 

40-50 

1813 

0.045 

50-60 

2217 

0.055 

60-70 

2016 

0.050 

70-80 

1848 

0.046 

80-90 

1774 

0.044 

80—100 

1355 

0.033 

100—200 

8909 

0.220 

200-300 

6197 

0.153 

300-400 

4477 

0.110 

400-500 

1353 

0.033 

500-600 

585 

0.014 

600-700 

395 

0.010 

700-800 

173 

0.004 

800-900 

144 

0.004 

900-1000 

153 

0.004 

1000-2000 

425 

0.010 

2000-3000 

163 

0.004 

3000-4000 

96 

0.002 

4000-5000 

92 

0.002 

5000-6000 

46 

0.001 

6000-7000 

31 

0 001 

7000-8000 

10 

0.0002 

8000-9000 

10 

0.0002 

9000-10000 

4 

0.0001 

OVER  10000 

4 

0.0001 

14  ' 2-7 


ORIGINAL  PAGE  IS 
OF  POOR  QUALITY 


Table  2-3.  Angular  Separation  Distribution  as  a Function  of  Time 
From  Observation  Epoch  and  Initial  Separation 


TIME  INTERVAL  = 30  YEARS 

INITIAL  SEPARATION 
(ARC  SECONDS) 

99%  PROBABILITY  INTERVAL 
(ARC  SECONDS) 

99.9%  PROBABILITY  INTERVAL 
(ARC  SECONDS) 

1.5 

0.0-  3.0 

0.0-  4 0 

2.5 

o 

1 

o 

0.0-  5.0 

3.5 

2.5-  5.0 

1 0-  6.0 

4.5 

3.0-  6.0 

• ’ 2.0-  7.0 

7.5 

o 

00 

1 

o 

5.0-  9.5 

12.5 

12.0-13.0 

10.0-15.0 

TIME  INTERVAL  = 75  YEARS 

1.5 

0.0-  3.5 

o 

in 

1 

o 

6 

2.5 

0.5-  45 

0 
b 

1 

O) 

o 

3.5 

o 

IT) 

1 

o 

o 

r** 

1 

o 

6 

4.5 

iS  : .</'■  ■ \ ^ - ^ 

0.5-  8.0 

7.5 

6.0-  8.5 

4.0-11.0 

12.5 

11.0-13.5 

8.0-16.0 

8 


SECTION  3 - CONCLUSIONS 

From  the  results  given  in  Table  2-3  and  the  distributions  of  angular  separation 
and  epoch  of  observation  given  in  Tables  3-1  and  3-2  (based  on  the  stars  con- 
tained in  the  SKYMAP  catalog,  the  limiting  magnitude  of  which  is  8.0  visual 
and  blue)  the  following  statements  are  justified  at  the  99.9  percent  probability 
level: 

• The  component  of  nearest-neighbor  angular  separation  error  attri- 
butable to  relative  motion  of  the  components  is  less  than  3 arc- 
seconds  for  stars  with  measured  separations  of  less  than 

5 arc-seconds  and  less  than  2 arc-seconds  for  those  with  measured 
separations  greater  than  5 arc-seconds. 

• The  probability  that  a nearest-neighbor  computation  of  2 arc- 
seconds  or  less  is  actually  greater  than  2 arc-seconds  is  about  0.05. 

• The  probability  that  a nearest-neighbor  computation  of  5 arc- 
seconds  or  less  is  actually  greater  than  5 arc-seconds  is  less  than 
0.01. 

These  results  refer  to  the  component  of  error  due  to  motion  of  the  multiple 
star  components  relative  to  one  another.  The  error  in  the  observation  of  the 
separation  is  another  component  of  the  total  error  (believed  to  be  less  than 
1 arc-second,  one  standard  deviation)  which  somewhat  increases  the  total  error. 

This  result  should  serve  as  a cautionary  flag  to  persons  using  the  Master  Cata- 
log word:  nearest-neighbor  in  the  Master  Catalog  greater  than  2 arc-seconds. 
Approximately  5 percent  of  these  stars  may  actually  have  a neighbor  2 to  5 arc- 
seconds  distant  that  was  not  considered  in  the  computation. 
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Table  3-1.  Distribution  of  Multiple  Star  Separations 


SEPARATION 

(ARC-SEC) 

NUMBER  OF  MASTER 
CATALOG  STARS 

CUMULATIVE 
FRACTION  OF  TOTAL 
MASTER  CATALOG 
STARS 

0-1 

1395 

0.031 

1-2 

837 

0.050 

2-3 

544 

0.062 

3-4 

402 

0.071 

4-5  - 

299 

0.078 

5-6 

278 

0.084 

6-7 

187 

0.088 

7-8 

176 

0.092 

8-9 

171 

0.096 

9-10 

133 

0.099 

10-15 

605 

0.113 

15-20 

423 

0.122 

20-25 

355 

0.130 

25-30 

286 

0.136 

30-35 

206 

0.141 

35-40 

160 

0.144 

40-45 

129 

0.147 

45-50 

113 

0.150 

50-55 

98 

0.152 

55-60 

84 

0.154 

60-65 

67 

0.155 

65-70 

70 

0.157 

70-75  ' 

53 

0.159 

75-80 

52 

0.160 

80-85 

41 

0 161 

85-90 

44 

0.162 

OVER  90 

81 

0 164 

TOTAL  KNOWN  MULTIPLE 
STARS  IN  THE  MASTER 
CATALOG 

7289 

0 164 

TOTAL  STARS  IN  THE 
MASTER  CATALOG 

44571 
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Table  3-2.  Epoch  of  Observation  of  Master  Catalog 
Multiple  Stars 


YEARS 

NUMBERS  OF  STARS 

1850-1859 

3 

1860-1869 

1 

1870-1879 

9 

1880-1889 

12 

1890-1899 

106 

1900-1909 

473 

1910-1919 

815 

1920-1929 

964 

1930-1939 

1166 

1940-1949 

1006 

1950-1959 

2304 

1960-1969 

499 

1970-1976 

62 
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ABSTRACT 


The  accuracy  of  the  SKYMAP  star  position  data  has  been  investigated  by  com- 
paring positions  in  two  different  source  catalogs.  Systematic  errors  in  one  of 
these  have  been  discovered  and  evaluated.  A method  for  computing  the  total 
error  in  position  as  a function  of  visual  magnitude  and  star  position  is  pre- 
sented, along  with  recommendations  to  improve  some  SKYMAP  positions. 
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SECTION  1 - INTRODUCTION 


This  report  examines  the  accuracy  of  the  star  positions  given  in  the  SKYMAP 
Master  Catalog  (see  Reference  1 for  a description  of  SKYMAP).  Knowledge 
of  the  accuracy  of  the  SKYMAP  positional  data  is  vital  when  using  the  SKYMAP 
catalog,  for  two  reasons.  First,  in  star  identification  routines,  an  observed 
star  is  identified  with  a catalog  star  only  if  the  positions  of  the  two  agree  to 
within  a given  tolerance.  When  calculating  this  tolerance,  allowance  must  be 
made  for  the  anticipated  error  in  the  star  catalog  positions  as  well  as  for  the 
errors  in  the  observed  star  positions.  Finally,  once  observed  stars  are  iden- 
tified with  catalog  stars,  an  attitude  is  computed  by  forcing  the  observations 
to  fall  as  closely  as  possible  on  the  catalog  star  positions.  It  may  be  desirable 
to  edit  out  catalog  stars  with  large  positional  uncertainties  before  an  attitude 
is  computed,  to  avoid  large  errors  in  the  solutions. 

The  errors  in  SKYMAP  positions  have  been  studied  to  place  reliable  estimates 
on  the  positional  errors,  and  to  discover  ways  to  improve  the  star  positions 
whenever  possible. 
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SECTION  2 - METHODOLOGY 


SKYMAP  star  positions  come  from  the  Smithsonian  Astrophysical  Observatory 
Star  Catalog  (SAO,  Reference  2),  and  the  Henry  Draper  Catalog  (HD,  Refer- 
ence 3).  The  SAO  positions  were  used  for  all  SAO  stars  in  SKYMAP.  Since 
both  SAO  and  SKYMAP  are  in  epoch  1950.  0,  no  adjustments  to  the  SAO  position 
were  required.  For  stars  not  in  the  SAO  (about  5 percent  of  SKYMAP  stars  to 
8.  0 visual  magnitude,  but  about  20  percent  of  SKYMAP  stars  to  9.  0 visual  mag- 
nitude), the  positions  given  in  the  HD  at  epoch  1900.  0 were  precessed  to  1950.  0 
and  then  adopted  as  SKYMAP  positions. 

Errors  in  the  SAO  positions  are  given  in  the  SAO  catalog  itself,  and  are  also 
reported  in  the  SKYMAP  positional  error  word.  These  are  usually  less  than 
1 arc-second,  and  always  less  than  3 arc-seconds  (one  standard  deviation). 
Errors  in  these  SKYMAP  positions  that  originated  in  the  HD  catalog  are  much 
larger. 

To  evaluate  the  size  of  the  errors  in  position  for  SKYMAP  stars  not  in  the  SAO, 
a comparison  was  made  of  SAO  positions  with  HD  positions  precessed  to 
1950. 0,  using  positions  of  SKYMAP  stars  contained  in  both  the  HD  and  the  SAO 
as  data.  Slightly  more  than  41 , 000  stars  were  used  in  this  study. 

Differences  in  the  SAO  positions  and  the  precessed  HD  positions  are  due  to  a 
combination  of  the  following  effects: 

• Errors  in  the  positions  reported  in  the  HD 

• Errors  in  the  precession  model  used  to  precess  the  HD  positions 
to  epoch  1950.0 

• Proper  motion  of  the  stars  from  1900.0  to  1950.  0 

• Errors  in  the  positions  reported  in  the  SAO. 
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The  first  source  of  error  was  found  to  be  the  dominant  one.  To  demonstrate 
this  point  the  other  sources  of  error  are  discussed  briefly. 

The  precession  model  was  tested  by  precessing  a grid  of  stars  from  the  Fourth 
Fundamental  Catalog  (FK4,  Reference  4)  from  epoch  1950.0  to  1975.0,  The 
FK4  positions  are  extremely  precise  (errors  less  than  0. 01  arc-seconds)  and 
are  given  in  both  of  these  epochs.  Therefore,  the  differences  in  the  FK4  posi- 
tions for  epoch  1975. 0,  and  the  FK4  positions  for  1950.  0 precessed  to  1975.  0 
using  our  model,  give  an  estimate  of  the  imprecision  of  the  model. 

In  no  case  did  the  precession  model  introduce  more  than  0. 5 arc-seconds  per 
century  of  error.  The  precession  needed  to  advance  HD  positions  to  the 
SKYMAP  epoch  is  from  1900. 0 to  1950. 0,  and  the  test  was  performed  on 
epochs  1950. 0 to  1975.  0.  However,  no  significant  additional  uncertainty  due 
to  the  earlier  epochs. is  anticipated. 

Proper  motions  of  the  stars  during  the  interval  1900. 0 to  1950. 0 contribute  to 
the  total  error.  However,  proper  motions  of  more  than  2 arc-seconds  per 
50  years  are  rare. 

Errors  in  the  reported  SAO  positions,  as  noted  above,  are  almost  always  less 
than  1 arc-second. 

Because  the  mean  difference  in  the  SAO  position  and  the  precessed  HD  position 
exceeded  20  arc-seconds  in  declination  and  20  arc-seconds  in  right  ascension, 
the  three  other  sources  of  error  discussed  above  can  be  ignored.  In  the  fol- 
lowing, the  entire  difference  is  referred  to  as  error  in  the  HD  position,  although 

% 

a small  fraction  of  this  error  is  actually  due  to  precession,  proper  motion,  and 
SAO  position  error. 
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To  evaluate  the  size  of  the  HD-position  errors,  the  following  four  measures 
were  computed  for  each  star: 

• The  error  in  right  ascension: 


Aa  = (acA^-a*D)  cos  6 


SAO 


SAO 


(2-1) 


where  ttgAQ  is  the  SAO  right  ascension,  is  the  HD  right 

ascension  precessed  to  epoch  1950.0,  and  6g  is  the  SAO  decli- 
nation. The  cos  5 term  is  employed  to  convert  an  angle  in 

jAvJ 

right  ascension  to  an  angular  distance  (along  a great  circle) . 

The  error  in  declination 


A6  = <6SAO-6H0>  (2-2> 

where  6 * is  the  HD  declination  precessed  to  epoch  1950. 0. 
xiD 

The  absolute  error  in  right  ascension 


A a = a 


SAO 


-a* 

HD1 


cos  6 


SAO 


(2-3) 


The  absolute  error  in  declination 


>A6|  = 15 


SAO 


- 6 * I 

HD 


(2-4) 


These  four  quantities  were  analyzed  as  a function  of  position  in  the  sky  and 
star  magnitude.  The  results  are  presented  in  Section  3. 
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SECTION  3 - RESULTS 


The  results  from  this  study  are  presented  in  the  following  three  parts : 

• Discussion  of  the  absolute  value  of  the  errors  in  right  ascension 
and  declination  as  a function  of  region  of  the  sky 

• Report  of  systematic  errors  in  right  ascension  and  declination  as 
a function  of  region  of  the  sky 

• Analysis  of  these  errors  as  a function  of  star  magnitude 

For  purposes  of  this  study,  the  sky  was  divided  into  144  regions,  defined  as 
follows.  Region  (I,  J)  contained  all  stars  such  that: 

(J-  1)  45°Sq;Sao  <(J)  45°  1SJS8 


and 


(3-1) 


90°  - 10°  (I)  5 6 < ioo°  - 10°  (I)  IS  IS  18 

SAO 

where  a is  the  SAO  right  ascension  of  the  star  (in  degrees),  and  6 

oAU  oAO 

is  its  declination. 

The  source  catalogs  from  which  the  SAO  and  HD  were  compiled  were  usualty 
limited  to  certain  declinations.  Variations  between  catalogs  show  up  most 
strongly  as  a variation  of  the  position  errors  as  a function  of  declination. 
Therefore,  the  regions  were  made  smaller  in  declination  than  in  right  ascen- 
sion to  more  precisely  delineate  error  variations. 

To  determine  if  more  significant  results  could  be  obtained  by  choosing  regions 
of  more  limited  right  ascension,  the  study  was  repeated  with  regions  offset 
22.5  degrees  in  right  ascension  from  that  of  the  original  study.  No  significant 
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differences  were  noted  between  the  two  studies.  It  is  therefore  concluded  that 
the  division  of  the  sky  which  was  used  satisfactorily  defined  the  variation  in 
position  errors. 

3. 1 ABSOLUTE  POSITION  ERRORS  AS  A FUNCTION  OF  REGION  OF  THE  SKY 

The  quantities  jAa|  and  | A 6 | from  Equations  (2-3)  and  (2-4)  are  the  abso- 
lute errors  in  right  ascension  and  declination,  respectively.  They  represent 
the  total  error  in  the  positions  taken  from  the  HD  catalog  and  precessed  to  the 
SKYMAP  epoch,  1950.  0.  They  include  random  errors,  i.e. , those  due  to  the 
round-off  in  the  HD  catalog  positions;  and  systematic  errors,  traceable  either 
to  the  source  catalogs  from  which  the  HD  was  produced  or  to  the  method  of 
reduction  of  source  catalog  data  by  the  HD  compilers. 

The  results  for  the  absolute  error  in  right  ascension  are  given  in  Table  3-1. 
Here  the  mean  absolute  error  is  written  in  seconds  of  arc,  and  is  presented 
as  a function  of  right  ascension  (J)  and  declination  (I)  , where.  J and  I are 
defined  in  Equation  3-1.  The  rightmost  column  and  the  bottom  row  are  the 
means  for  all  stars  in  that  declination  or  right  ascension  region,  respectively. 
The  value  in  the  lower  right  corner  is  the  mean  for  the  entire  sky. 

The  results  for  absolute  error  in  declination  are  given  in  the  same  format  in 
Table  3-2. 

The  standard  deviations  in  the  absolute  error  in  right  ascension  are  given  in 
Table  3-3,  and  those  for  declination  are  given  in  Table  3-4.  These  quantities 
are  important  because  they  are  an  estimate  of  how  accurate  the  HD  positions 
can  become  if  they  are  corrected  for  systematic  effects.  For  example,  for 
the  region  1 = 1,  J = 4 , the  mean  absolute  error  in  right  ascension  is 
65. 0 arc-seconds.  The  standard  deviation  in  the  absolute  error  in  right  as- 
cension, however,  is  only  24.6  arc-seconds;  converted  to  an  equivalent  mean 
error,  that  is  about  20  arc-seconds.  The  fact  that  the  standard  deviation  is 
substantially  less  than  the  mean  absolute  error  implies  that  the  mean  error 
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Table  3-1.  Mean  Absolute  Errors  in  Right  Ascension 
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Table  3-2.  Mean  Absolute  Errors  in  Declination 
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differs  notably  from  zero,  and  that  the  mean  absolute  error  could  be  reduced 
by  correcting  the  HD  positions  in  a systematic  way.  In  fact,  as  noted  below, 
the  mean  (systematic)  error  in  right  ascension  was  44  arc-seconds  for  this 
region. 

Table  3-5  presents  the  number  of  data  points  (stars)  in  each  region  of  the  sky. 
Because  some  regions  have  relatively  few  stars,  statistical  imprecision  cannot 
be  ignored.  To  obtain  more  insight  into  which  variations  in  the  mean  absolute 
errors  were  statistically  significant,  the  z-scores  of  the  means  (i.e. , the  num- 
ber of  standard  deviations  from  the  whole  sky  mean)  were  computed  from  the 
following  formula: 


V#Vw/p  i? 


(3-2) 


where  Z.^  = the  z-score  for  the  region  (I,  -J) 
= the  mean  for  the  region  (I,  J) 


O'  * 

ij 


= the  whole-sky  mean  (21. 0 arc-seconds  for  right  ascension  and 
25.7  arc-seconds  for  declination),  and 

= the  standard  deviation  in  the  mean  for  region  (I,  J)  as  computed 
from  Equation  3-3: 


0*  =o  ../J  N„ 

i]  i]  v ij 


(3-3) 


where  o\.  = the  standard  deviation  of  the  data  from  the  mean  for  region  (I,  J), 
13  and 


N..  = the  number  of  data  points  in  region  (I,  J). 


X'  3-7 


Table  3-5.  Number  of  Data  Points  in  Each 
Region  in  the  Sky 
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The  z-scores  for  absolute  error  in  right  ascension  are  presented  in  Figure  3-1 
and  the  same  scores  for  absolute  error  in  declination  are  shown  in  Figure  3-2. 
Lines  are  drawn  around  those  parts  of  the  sky  where  the  z-score  exceeds  x3 
(solid  lines)  or  is  less  than  -3  (dashed  lines). 

The  analysis  of  covariance,  which  is  a rigorous  statistical  test  (see  Refer- 
ence 5)  was  applied  to  the  data  to  answer  the  following  questions: 

• Is  there  any  significant  variation  in  the  mean  absolute  errors  as  a 
function  of  right  ascension  within  the  declination  areas  ? 

• Is  there  any  significant  variation  as  a function  of  declination  within 
the  right  ascension  areas  ? 

The  F-ratio  statistic  showed  significant  variations  within  each  right  ascension 
region  for  the  absolute  mean  errors  in  both  right  ascension  and  declination. 

The  results  showed  significant  variation  within  declination  regions  for  only  one 
region  of  right  ascension  for  the  mean  absolute  error  in  right  ascension,  and 
for  only  two  regions  for  the  mean  absolute  error  in  declination.  It  can  be  con- 
cluded that  the  mean  absolute  errors  in  both  right  ascension  and  declination  can 
be  adequately  represented  as  a function  of  declination  alone. 

Table  3-6  is  a convenient  summary  of  these  results  and  is  adapted  from  the 
data  presented  in  Tables  3-1  and  3-2. 

Table  3-6  shows  that  the  mean  absolute  error  in  right  ascension  is  constant  at 
a value  of  about  20  arc-seconds  for  stars  with  declinations  between  +60  and 
-60  degrees.  The  table  also  shows  that  for  other  declinations,  the  mean  error 
increases  approximately  as  the  function: 


\Aa\ 


= -109.  6 - 4.  64  | 6, 


SAO ' 


0.04  16 


SAO1 


(3-4) 
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Figure  3-2.  Z-Seores  for  the  Mean  Absolute  Error  in  Declination 
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Table  3-6.  Mean  Absolute  Errors  as  a Function 
of  Declination 


DECLINATION 

REGION 

(DEGREES) 

MEAN  ABSOLUTE  ERROR 
IN  RIGHT  ASCENSION 
(ARC  SECONDS) 

MEAN  ABSOLUTE  ERROR 
IN  DECLINATION 
(ARC  SECONDS) 

+90  TO  +80 

48 

24 

+80  TO  +70 

31 

29 

+70  TO  +60 

24 

29 

+60  TO  +50 

22 

28 

+50  TO  +40 

21 

29 

+40  TO  +30 

19 

29 

+30  TO  +20 

19 

28 

+20  TO +10 

20 

30 

+ 10  TOO 

21 

28 

OTO  -10 

20 

23 

-10  TO  -20 

19 

23 

-20  TO  -30 

18 

23 

-30  TO  -40 

19 

23 

-40  TO  -50 

20 

22 

-50  TO  -60 

21 

22 

-60  TO  -70 

24 

22 

-70  TO  -80 

32 

23 

-80  TO  -90 

48 

26 

WHOLE  SKY 

21 

26 

Syjrjf*  70*'?  3KAJ3  3SAR  £Mir 
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where  is  the  declination  in  degrees,  and  e , , , is  the  mean  absolute 

SAO  I A O'! 

error  in  right  ascension  in  arc-seconds. 

The  mean  absolute  error  in  declination  can  be  represented  as  a constant 
(29  arc-seconds)  for  stars  with  positive  declinations,  and  another  constant 
(23  arc-seconds)  for  stars  with  negative  declinations. 

3.2  SYSTEMATIC  POSITION  ERRORS  AS  A FUNCTION  OF  POSITION  IN  THE 
SKY 

The  quantities  A^  and  A ^ from  Equations  (2-1)  and  (2-2)  are  the  (signed) 
errors  in  the  right  ascension  and  declination,  respectively.  When  averaged 
over  the  regions  of  the  sky  defined  above,  they  represent  systematic  errors  in 
the  star  positions.  These  systematic  errors  can  be  corrected,  thereby  reduc- 
ing the  total  error  in  position. 

Tables  3-7  and  3-8  present  the  mean  error  in  right  ascension  and  declination 

as  a function  of  region  of  the  sky.  J and  I define  the  regions  as  in  Equa- 

* 

tion  (3-1).  The  format  of  the  tables  is  the  same  as  that  of  Table  3-1. 

Since  some  regions  had  very  few  stars  (see  Table  3-5),  a z-score  was  computed 
to  specify  where  deviations  from  zero  systematic  error  were  statistically  sig- 
nificant: 

z..  = u../ct*  (3-5) 

i]  i]  i] 

the  z-score  for  the  region  (I,  J) 
the  mean  error  for  the  region  (I,  J),  and, 
the  standard  deviation  in  the  mean  error  for  region  (I,  J)  , as 
defined  in  Equation  (3-6): 


where  z . . = 
U 


Table  3-7.  Mean  Errors  in  Right  Ascension 
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where  <7.  = the  standard  deviation  of  the  data  from  the  mean  for  region  (I,  J), 
1J  and 

N_  = the  number  of  data  points  in  region  (I,  J). 

Figures  3-3  and  3-4  present  the  z-scores  for  the  mean  errors  in  right  ascen- 
sion and  declination,  respectively.  Again,  solid  and  dashed  lines  enclose  the 
regions  which  deviate  more  than  three  standard  deviations  from  zero-mean  er- 
ror in  the  positive  and  negative  directions,  respectively. 

An  analysis  of  convariance  on  the  errors  in  right  ascension  showed  no  signifi- 
cant deviations  from  a mean  error  of  zero  as  a function  of  either  right  ascen- 
sion or  declination.  Furthermore,  an  inspection  of  Figure  3-3  shows  no  large 
scale  positive  or  negative  features.  It  can  be  concluded  that  there  are  no  sig- 
nificant systematic  errors  in  right  ascension. 

The  analysis  of  covariance  on  the  errors  in  declination  revealed  significant  de- 
viations from  a mean  error  of  zero  as  a function  of  right  ascension  for  each 
declination  region,  and  as  a function  of  declination  for  each  right  ascension 
region.  Additional  analysis  of  covariance  statistics  were  obtained  for  selected 
groups  of  regions  in  an  attempt  to  isolate  areas  of  the  sky  where  the  mean  error 
in  declination  was  constant  to  within  statistical  precision.  However,  only  very 
small  areas  could  be  found. 

Therefore,  the  individual  values  given  in  Table  3-8  have  been  adopted  as  the 
best  values  for  the  systematic  error  in  declination. 

3.3  ABSOLUTE  POSITION  ERRORS  AS  A FUNCTION  OF  VISUAL  MAGNITUDE 

All  stars  in  the  study  were  divided  into  five  groups  based  upon  visual  magnitude 
defined  in  the  following  tabulation: 

Group  Number  Visual  Magnitude  Number  in  Group 

1 Less  than  5.0 

2 5. 0 to  6. 0 
6.  0 to  7. 0 


3 
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1,568 

3,468 

10,465 
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Figure  3-3.  Z-Seores  for  the  Mean  Error  in  Right  Ascension 
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Group  Number  Visual  Magnitude  Number  in  Group 

4 7.0  to  8.0  19,033 

5 8.  0 to  9.  O’*  6,528 

The  mean  absolute  error  in  right  ascension  and  declination  was  computed  for 
each  group.  The  results  are  presented  in  Table  3-9.  Analyses  of  covariance 
performed  on  this  data  revealed  that  the  mean  absolute  error  in  right  ascension 
was  constant  to  within  statistical  precision  for  stars  of  visual  magnitude  5.  0 
and  brighter.  However,  all  groups  differed  significantly  from  one  another  in 
the  mean  absolute  error  in  declination,  except  for  groups  4 and  5. 

3.4  POSITION  ERRORS  AS  A FUNCTION  OF  VISUAL  MAGNITUDE 

No  significant  differences  (at  the  95  percent  confidence  level)  were  found  be- 
tween magnitude  groups  in  either  the  mean  error  in  right  ascension  or  the  mean 
error  in  declination. 


*Most  are  between  8.  0 and  8. 3. 
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SECTION  4 - DISCUSSION 

4. 1 THE  SIZE  OF  THE  ERRORS  IN  POSITION 

This  subsection  presents  a summary  of  the  results  presented  in  Section  3.  For 
stars  appearing  in  the  SAO,  errors  in  position  are  less  than  1 arc-second  for 
most  stars,  and  are  always  less  than  3 arc-seconds. 

For  stars  not  appearing  in  the  SAO,  the  precessed  HD  positions  have  positional 
uncertainties  (as  presented  in  Tables  3-1  and  3-2).  These  uncertainties  are  a 
function  of  declination,  but  not  of  right  ascension,  as  noted  in  Table  3-6.  The 
mean  error  in  the  absolute  value  of  the  right  ascension  can  be  taken  as  20  arc- 
seconds  for  stars  with  declinations  between  +60  and  -60  degrees,  and  is  given 
by  Equation  (3-4)  for  stars  with  other  declinations.  The  mean  absolute  error 
in  declination  is  29  arc-seconds  for  stars  with  positive  declinations  and  23  arc- 
seconds  for  stars  with  negative  declinations. 

A slight  adjustment  based  on  visual  magnitude  is  made  by  subtracting  2. 7 arc- 
seconds  from  the  mean  absolute  error  in  right  ascension  for  stars  brighter  than 
5. 0 magnitude.  Similarly,  the  mean  absolute  error  in  declination  is  decreased 
by  6.5  arc-seconds  for  stars  with  magnitudes  brighter  than  5.  0;  by  3. 6 arc- 
seconds  for  stars  with  visual  magnitudes  between  5.  0 and  6.  0;  and  is  increased 
by  1. 0 arc-seconds  for  stars  dimmer  than  7.  0 magnitude. 

Systematic  errors  in  position  were  found  only  for  the  error  in  declination  (see 
Table  3-8)  and  were  usually  of  about  10  to  20  arc-seconds  amplitude. 

4.2  IMPROVING  THE  POSITIONS 

HD  declinations  can  be  improved  by  subtracting  the  systematic  errors  (noted  in 
Table  3-8)  from  the  declinations  of  the  individual  stars.  This  should  decrease 
the  mean  errors  in  declination  to  values  of  approximately  the  standard  devia- 
tions given  in  Table  3-4. 
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An  even  greater  improvement  in  SKYMAP  positions  can  be  realized  by  adopting 
the  positions  available  in  the  Catalog  der  Astronomischen  Gesellschaft-3 
(AGK-3,  Reference  6).  The  SAO  catalog  was  compiled  using  positional  data 
from  various  source  catalogs,  including  the  Catalog  der  Astronomischen 
Gesellschaft-2  (AGK-2,  Reference  7),  the  predecessor  of  the  AGK-3.  The 
AGK-3  positions  are  slightly  more  accurate  than  those  of  the  AGK-2;  further- 
more, a large  number  of  additional  stars,  especially  in  the  Southern  Hemi- 
sphere, are  included  in  the  AGK-3. 

It  is  not  known  at  this  time  how  many  SKYMAP  stars  not  in  the  SAO  catalog  are 
in  the  AGK-3.  Using  the  AGK-3  positions,  however,  would  decrease  the  num- 
ber of  stars  for  which  HD  positions  (with  their  large  attendant  uncertainties) 
would  have  to  be  adopted. 

4.3  A FUNDAMENTAL  LIMIT  TO  THE  ACCURACY  OF  HD  POSITIONS 

No  amount  of  analysis  will  be  able  to  reduce  the  HD  positional  uncertainties 
below  those  imposed  by  the  round-off  of  the  positions  reported  in  the  HD  catalog. 
The  HD  gives  declinations  to  the  nearest  arc-minute,  resulting  in  a mean  ab- 
solute error  in  declination  of  15  arc-seconds.  Because  the  mean  absolute  error 
noted  in  Table  3-2  is  25.  7 arc-seconds,  and  because  several  arc-seconds  of 
that  may  be  due  to  precession  model  inaccuracies,  proper  motion,  and  errors 
in  the  SAO  position,  only  a very  limited  reduction  in  the  mean  absolute  error 
in  declination  can  be  achieved.  Most  (if  not  all)  of  that  reduction  will  be 
achieved  by  subtracting  the  systematic  error  in  declination  reported  in  Sec- 
tion 3-2,  leaving  a mean  absolute  error  of  approximately  2-  arc-seconds  (see 
Table  3-4). 

In  right  ascension,  the  situation  is  more  complex.  The  HD  reports  right  as- 
censions to  0.1  minute  of  time,  which  is  equivalent  to  90  cos  6 (arc-seconds) 
where  6 is  the  star  declination. 
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The  mean  absolute  error  in  right  ascension,' therefore,  will  always  be  at  least 
22.5  cos  6 arc-seconds.  Table  4-1  gives  the  mean  absolute  error  in  right  as- 
cension for  each  declination  interval  studied,  including  (for  comparison)  the 
minimum  error  as  computed  from  the  above  formula. 

For  most  of  the  stars  in  the  study,  the  mean  absolute  error  in  right  ascension 
is  slightly  below  the  lower  limit  imposed  by  round-off.  We  have  no  explanation 
for  this  phenomenon,  except  that,  statistically,  it  is  only  marginally  significant. 

Significant  reductions  in  the  mean  absolute  error  can  theoretically  be  attained 
only  for  those  stars  with  declinations  north  of  +40  degrees  or  south  of  -40  de- 
grees. Correlation  of  error  in  right  ascension  has  not  been  found  with  any 
other  variable;  therefore,  no  action  can  be  taken  to  reduce  these  errors  at 
this  time. 
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Table  4-1.  Mean  Absolute  Error  in  Right  Ascension 
and  its  Lower  Limit 


DECLINATION 

(DEGREES) 

MEAN  ABSOLUTE  ERROR 
(ARC  SECONDS) 

LOWER  LIMIT 
(ARC  SECONDS) 

+90  TO  +80 

48.0 

2.8 

+80  TO  +70 

31.0 

6.6 

+70  TO  +60 

23.6 

10.7 

+60  TO  +50 

22.2 

13.5 

+50  TO  +40 

21.1 

15.3 

+40  TO  +30 

19.3 

18.6 

+30  TO  +20 

19.2 

20.6 

+20  TO +10 

19.8 

21.7 

OTO  +10 

21.1 

22.3 

-10  TOO 

19.9 

22.3 

-20  TO -10 

19.3 

21.7 

-30  TO  -20 

18.2 

20.6 

-40  TO  -30 

18.8 

18.6 

-50  TO  -40 

20.1 

15.3 

-60  TO  -50 

21.2 

13.5 

-70  TO  -60 

24.1 

10.7 

-80  TO  -70 

32.1 

6.6 

-90  TO  -80 

48.1 
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ABSTRACT 


The  completeness  of  two  star  catalogs  which  are  the  source  of  most  SKYMAP 
stars  has  been  studied  by  means  of  star  counts.  The  projected  completeness 
of  the  SKYMAP  Star  Catalog  at  various  limiting  magnitudes  is  inferred. 
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SECTION  1 - INTRODUCTION 


The  SKYMAP  Star  Catalog  (Reference  1)  was  compiled  from  several  source 
catalogs,  primarily  the  Henry  Draper  catalog  (HD,  Reference  2)  and  the 
Smithsonian  Astrophysical  Observatory  catalog  (SAO,  Reference  3).  To  deter- 
mine the  projected  completeness  level  of  the  9.0-magnitude  SKYMAP  catalog 
now  being  compiled,  the  completeness  of  the  HD  and  the  SAO  star  catalogs  by 
means  of  star  counts  was  investigated.  The  technique  is  described  in  Section  2. 
The  SKYMAP  star  catalog  will  be  at  least  as  complete  as  any  one  of  the  source 
catalogs. 

The  investigation  discussed  in  Sections  2 and  3 shows  that  SKYMAP  will  be  at 
least  93-percent  complete  at  8.  0 visual  magnitude,  77-percent  complete  at  9.0, 
and  about  45-  to  50-percent  complete  at  10.  0 (if  extended  that  far). 

In  terms  of  blue  magnitude,  it  will  be  100-percent  complete  at  8.  0 blue  magni- 
tude, and  at  least  98-percent  complete  at  9.0  blue  magnitude.  If  some  of  the 
stars  missing  from  the  HD  catalog  are  in  the  SAO  catalog,  the  completeness 
levels  of  the  SKYMAP  catalog  will  be  higher  than  these  minimum  estimates. 
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SECTION  2 - TECHNIQUES 

2.1  DIRECT  COMPARISONS 

One  method  to  check  the  completeness  of  a star  catalog  is  to  observe  all  stars 
within  a certain  range  of  magnitude  in  a certain  region  of  the  sky  and  then  de- 
termine what  fraction  of  these  stars  are  in  the  catalog.  Such  a task  would  be 
formidable  for  the  whole  sky.  For  certain  types  of  stars,  a few  regions  of 
the  sky  have  been  extensively  observed  (References  4 and  5).  These  may  be 
used  to  spot  check  the  completeness  level  of  the  catalog.  Unfortunately,  the 
samples  available  for  comparison  using  this  method  are  so  small  that  they  are 
statistically  insignificant. 

2.2  STAR  COUNT  METHOD 

Another  method  used  to  estimate  completeness  is  the  star  count  method.  As- 
sume that  stars  are  uniformly  distributed  in  space.  Then  the  number  of  stars, 
N(r)  , located  within  a distance,  r , would  be  proportional  to  the  cube  of  the 
distance 


N(r)  = cr^  (2-1) 

where  c is  a proportionality  constant. 

The  apparent  magnitude,  m , and  the  absolute  magnitude,  M , are  related  by 
the  equation 

m - M = 5 log  r - 5 (2-2) 

which  is  equivalent  to 


r = 100.2(m-M)+I 


(2-3) 
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Assuming  that  stars  are  distributed  uniformly  in  an  infinite  space,  and  that  all 
stars  have  the  same  intrinsic  brightness  (absolute  magnitude) , and  combining 
Equations  (2-1)  and  (2-3), 


N(m)  = c(10 


0.6m+K) 


(2-4) 


or 


log  N(m)  = 0.  6m  + K'  (2-5) 

where  K and  K'  are  empirical  constants.  The  spatial  distribution  of  stars 
is  not  uniform,  and  stars  do  not  all  have  the  same  absolute  magnitude,  so  the 
relationship  described  in  Equation  (2-5)  is  not  always  valid.  However,  there  is 
empirical  evidence  (Reference  6)  that  the  plot  of  log  N(m)  versus  m does 
show  a linear  relationship  for  stars  brighter  than  10.0  magnitude,  although  the 
slope  is  smaller  than  0.6. 

Mihalas  (Reference  4)  quotes  empirical  results  which  yield  a slope  of  approxi- 
mately 0.47  for  stars  brighter  than  about  10th  visual  magnitude. 

For  both  the  HD  and  the  SAO,  the  number  of  stars  N(m)  over  the  whole  sky 
within  apparent  magnitude  intervals  0. 1-magnitude  wide  was  counted.  Then 
log  N(m)  versus  m was  plotted.  The  range  of  apparent  magnitude  for  which 
a linear  function  appeared  on  the  plot  defines  the  range  of  completeness  of  the 
catalogs.  Section  3 describes  these  results  in  detail. 
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SECTION  3 - RESULTS 


3.1  HENRY  DRAPER  CATALOG 

Figure  3-1  is  the  plot  of  log  N(m)  versus  m for  the  HD  photovisual  magnitudes. 
The  equation  of  the  line  is  log  N = 0. 50m  + 0. 715  . The  linear  relation  extends 
to  visual  magnitude  7.2.  It  is  concluded  that  the  HD  is  complete  to  an  approxi- 
mate visual  magnitude  of  7. 2. 

Similarly,  Figure  3-2  shows  a linear  relationship  in  the  plot  of  HD  photographic 
magnitudes  to  8.7  magnitude.  The  equation  of  the  line  is  log  N = 0.48m  + 

0.618  . 

By  extrapolating  the  linear  portion  of  the  log  N(m)  versus  m plots,  the  com- 
pleteness level  of  the  HD  star  catalog  as  a function  of  magnitude  is  computed. 
Tables  3-1  and  3-2  give  the  completeness  level  of  the  HD  in  terms  of  photovisual 
and  photographic  magnitudes,  respectively. 

3. 2 SMITHSONIAN  ASTROPHYSICAL  OBSERVATORY  CATALOG 

Figure  3-3  is  a log  N(m)  versus  m plot  for  the  SAO  star  catalog  photovisual 
magnitudes,  indicating  completeness  to  7.3  magnitude.  The  equation  of  the 
line  is  log  N = 0. 50m  + 0.  718  . Above  7. 3 magnitude  the  plot  is  erratic  due 
to  the  low  quality  of  SAO  magnitudes.  Consequently,  no  reliable  estimate  of 
completeness  can  be  made. 

However,  the  procedure  outlined  for  HD  produced  completeness  estimates  that 
are  best  described  as  upper  limits  to  the  true  completeness.  Table  3-3  pre- 
sents these  estimates.  These  figures  indicate  true  completeness  of  the  SAO 
not  exceeding  85  percent  at  8.  0 magnitude,  70  percent  at  9.  0 magnitude,  and 
49  percent  at  10.0  magnitude. 

Because  more  than  49  percent  of  the  stars  in  the  SAO  catalog  do  not  have  photo- 
graphic magnitudes,  no  inference  can  be  drawn  about  the  SAO  star  catalog  in 
terms  of  photographic  magnitude. 
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Table  3-1. 


Completeness  Level  of  the  HD  Catalog  in  Terms  of 
Photovisual  Magnitudes 


m 

COMPLETENESS 
(IN  PERCENT) 

< 7.2 

100.0 

7.3 

97.1 

7.4 

95  3 

7.5 

93.5 

7.6 

91.8 

7.7 

91.2 

7.8 

90.2 

7.9 

91 .0 

8.0 

92.7 

8.1 

92.9 

8.2 

91.8 

8.3 

89.9 

8.4 

87.7 

8.5 

87.1 

8.6 

86.7 

8.7 

85.7 

8.8 

82.6 

8.9 

80.5 

9.0 

77.4 

9.1 

74.6 

9.2 

71.8 

9.3 

67.9 

9.4 

63.4 

9.5 

59.2 

9.6 

54.8 

9.7 

50.5 

9.8 

46.5 

9.9 

42.4 
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Table  3-2.  Completeness  Level  of  the  HD  Catalog  in  Terms  of 
Photographic  Magnitudes 


m 

COMPLETENESS 
UN  PERCENT) 

< 8.7 

100.0 

8.8 

99.3 

8.9 

99.1 

9.0 

97.9 

9.1 

96.4 

9.2 

95.5 

9.3 

92.9 

9.4 

89.9 

9.5 

87.1 

9.6 

83.4 

9.7 

80.0 

9,8 

76.2 

9.9 

71.8 

'S' 
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Table  3-3 


. Upper  Limit  to  the  Completeness  Level  of  the  SAO 
Catalog  in  Terms  of  Photovisual  Magnitudes 


m 

COMPLETENESS 
(IN  PERCENT) 

< 7.3 

100.0 

7.4 

91 .6 

7.5 

91 .4 

7.6 

88.9 

7.7 

94.2 

7.8 

92.7 

7.9 

84.7 

8,0 

88.9 

8.1 

87.5 

8.2 

97.9  . 

8.3 

99.3 

8.4 

89.9 

8.5 

95.1 

8.6 

97.7 

8.7 

114.0 

8.8 

115.1 

8.9 

103.7 

9.0 

109.9 

9.1 

106.9 

9.2 

106.9 

9.3 

99.3 

9.4 

88.9 

9.5 

88.2 

' 9.6 

74.5 

9.7 

67.6 

9.8 

60.7 

9.9 

54.2 

10.0 

49.1 
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ABSTRACT 


This  document  describes  the  source  catalogs  from  which  SKYMAP  data  was 
compiled.  The  variables  obtained  from  each  catalog  are  enumerated.  Several 
potential  source  catalogs  not  used  in  creating  SKYMAP  are  also  described,  and 
reasons  are  presented  for  not  using  the  data  they  contain. 
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SECTION  1 - INTRODUCTION 


SKYMAP  (Reference  1)  is  a compendium  of  stellar  data  specifically  designed 
for  analysis  of  star  sensor  data  for  attitude  determination.  Most  of  the  data 
in  SKYMAP  comes  directly  from  1 of  10  star  catalogs.  Each  of  these  "source'' 
star  catalogs  contains  some,  but  not  all,  of  the  data  needed  for  some  of  the 
stars  included  in  SKYMAP.  By  combining  the  data  of  the  source  catalogs,  a 
data  base  was  formed  from  which  the  final  SKYMAP  catalog  was  generated. 

This  report  describes  each  of  the  star  catalogs  considered  for  use  as  a source 
catalog  for  SKYMAP,  regardless  of  whether  the  catalog  was  eventually  used  or 
not.  Within  each  catalog  description  is  a definition  of  data  taken  from  that  cata- 
log and  whether  it  was  a primary  or  secondary  source  of  that  data.  Included 
are  explanations  for  the  rejection  of  some  catalog  data.  The  most  recently 
issued  catalog  is  the  primary  data  source  unless  an  earlier  issue  was  considered 
to  be  more  accurate  or  more  reliable.  When  this  occurs,  reasons  are  included 
for  choosing  the  earlier  catalog.  Catalogs  in  this  document  are  referred  to  by 
a short  descriptive  name.  Table  1-1  gives  the  complete  name  of  the  catalog, 
the  short  name,  and  the  reference  number  for  each  of  the  catalogs  referred  to. 
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Table  1-1.  Catalogs  Considered  as  Sources  of  SKYMAP  Data 


SECTION  2 - SOURCE  CATALOG  DESCRIPTIONS 


2. 1 HENRY  DRAPER  CATALOG 

The  Henry  Draper  Catalog  (HD)  is  the  primary  source  for  star  numbers  and  a 
secondary  source  for  positions  (behind  the  Smithsonian  Astrophysical  Observa- 
tory Catalog,  SAO),  spectral  types  (behind  the  Jascheck,  Mermilliod,  and 
Blanco  catalogs),  and  magnitudes  (behind  the  Mermilliod,  Blanco,  Jaschek,  and 
Kukarkin  catalogs) . The  Durchmusterung  number  (DM  number)  from  the  HD  is 
also  used  by  SKYMAP.  Disagreements  between  DM  numbers  found  in  both  the 
HD  and  SAO  were  resolved  manually  on  a case-by-case  basis. 

2.2  HENRY  DRAPER  EXTENSION  (HDE) 

The  HDE  is  an  extension  of  the  HD  to  dimmer  stars  for  limited  regions  of  the 
sky.  The  data  taken  from  the  HDE  is  the  same  as  the  data  taken  from  the  HD. 

2.3  SMITHSONIAN  ASTROPHYSICAL  OBSERVATORY  (SAO)  STAR  CATALOG 

The  SAO  is  the  primary  source  of  positions,  position  errors,  and  proper  mo- 
tions. Only  the  Astronomische  Gesellschaft  Katalog-3  (AGK-3)  is  newer  than 
the  SAO;  it  is  not  used  because  its  reliability  has  not  yet  been  verified.  The 
SAO  is  a secondary  source  for  spectral  types  (behind  Jaschek,  Mermilliod, 
Blanco,  the  HD,  and  the  HDE  catalogs),  and  for  magnitudes  (behind  Mermilliod, 
Blanco,  Jaschek,  Kukarkin,  the  HD,  and  the  HDE  catalogs).  Durchmusterung 
numbers  for  stars  not  in  the  HD  come  from  the  SAO.  For  stars  in  both  the  HD 
and  SAO,  DM  numbers  not  identical  in  the  two  catalogs  were  resolved  manually 
on  a case-by-case  basis. 

2.4  BONNER  DURCHMUSTERUNG  (B D) /C ORDOB A DURCHMUSTERUNG  (CD)/ 
CAPE  PHOTOGRAPHIC  DURCHMUSTERUNG  (CPD) 

The  BD/CD/CPD  catalogs  are  old  positional  catalogs.  Collectively,  they  cover 
the  entire  sky,  and  contain  more  stars  than  any  of  the  other  source  catalogs. 
However,  they  are  only  incompletely  available  on  magnetic  tape;  even  those 
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portions  that  are  on  tape  are  generally  not  quality-assured.  The  SAO  and  AGK-3 
catalogs  are  compiled  from  these  and  similar  catalogs,  with  appropriate  data 
reduction  procedures  applied.  Therefore,  the  BD/ CD/ CPD  catalogs  are  not 
used  as  source  material  for  SKY  MAP. 

2.5  ASTRONOMISCHE  GESELLSCHAFT  KATALOG-3 

The  AGK-3  is  the  most  modern  catalog  of  stellar  positions  for  stars  north  of 
declination  -2  degrees.  Stars  south  of  this  declination  are  not  contained  in  the 
AGK-3.  Positions  and  proper  motions  available  in  the  AGK-3  are  probably  the 
most  accurate  extant.  However,  the  tape  version  of  the  catalog  has  not  been 
quality-assured.  Preliminary  inspection  indicates  the  existance  of  a small  num- 
ber of  typographical  errors.  The  difference  in  positions  given  in  the  AGK-3 
and  in  the  SAO  (currently  the  primary  source  of  positions)  is  under  study  at  this 
time.  Until  the  AGK-3  is  sufficiently  quality-assured,  however,  it  will  not  be 
used  as  a source  of  SKY MAP  data. 

2. 6 UNITED  STATES  NAVAL  OBSERVATORY  PHOTOMETRY  CATALOG 

Blanco  is  a secondary  source  of  star  magnitudes  (behind  Mermilliod).  It  is  a 
compendium  of  most  Ultraviolet- Blue- Visual  photometry  (UBV)  done  before 
1967.  Blanco  also  serves  as  a secondary  source  of  spectral  types  (behind 
Jaschek  and  Mermilliod). 

2. 7 STRASBOURG  PHOTOMETRY  CATALOG 

Mermilliod  is  a compendium  of  UBV  photometry  made  available  after  the  publi- 
cation of  Blanco  and  before  1975  (approximately).  The  intent  of  the  issuers  is 
to  keep  it  current  by  the  addition  of  new  data  as  it  becomes  available  to  them. 
Mermilliod  is  the  primary  source  of  UBV  photometry  and  a secondary  source 
of  spectral  types  (behind  Jaschek). 
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2.8  JASCHEK  SPECTRAL  TYPE  CATALOG 

Jaschek  is  a collection  of  spectral  types  reported  prior  to  1964.  It  is  the  pri- 
mary source  of  spectral  types,  and  a secondary  source  of  UBV  photometry 
(behind  Mermilliod  and  Blanco). 

2.9  MICHIGAN  SPECTRAL  TYPE  CATALOG 

A project  at  the  University  of  Michigan  to  observe  new  spectral  types  for  all 
HD  stars  is  currently  in  progress,  but  only  about  one-fourth  of  the  results  are 
available.  This  catalog  will  eventually  become  the  best  source  of  spectral  types. 
However,  it  is  still  only  partially  complete  and  has  not  been  quality-assured. 
Therefore,  it  is  not  currently  used  as  a source  of  SKYMAP  data. 

2. 10  GENERAL  CATALOG  OF  TRIGONOMETRIC  STELLAR  PARALLAXES 

Jenskins  is  a compilation  of  stellar  parallax  data.  Although  it  is  about  25  years 
old,  very  little  additional  data  has  become  available  since  its  publication.  It  is 
this  study's  only  source  of  trigonometric  parallax  and  error  in  trigonometric 
parallax  data. 

2. 11  CATALOG  OF  RADIAL  VELOCITIES 

Wilson  is  a compendium  of  radial  velocities  over  10  years  old.  It  is  not  a source 
of  SKYMAP  data  because  a new  catalog  (Evans)  is  almost  ready  for  use  and 
because  radial  velocities  are  not  a crucial  parameter  for  attitude  determination. 

2.12  EVANS  RADIAL  VELOCITY  CATALOG 

Evans  is  available  in  printed  form,  but  not  on  magnetic  tape.  It  is  recommended 
that  the  relevant  portions  of  the  catalog  be  card-punched  and  put  on  tape  for  in- 
clusion in  SKYMAP.  However,  at  this  time,  it  is  not  a source  of  SKYMAP  data. 

2. 13  INDEX  CATALOG  TO  VISUAL  DOUBLE  STARS 

The  Multiple  Star  Catalog  is  the  most  modern  available  collection  of  multiple 
star  data,  and  is  the  only  source  of  multiple  star  data  for  SKYMAP. 
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2. 14  GENERAL  CATALOG  OF  VARIABLE  STARS 


Kukarkin  is  the  most  modern  available  compilation  of  variable  star  data,  and 
is  the  only  source  of  variable  star  data  for  SKYMAP. 

2. 15  CATALOG  OF  BRIGHT  STARS 

The  YBSC  is  a compendium  of  stellar  data  similar  to  SKYMAP  but  limited  to 
the  9100  brightest  stars  in  the  sky  (about  6.2  magnitude).  It  is  used  as  a pri- 
mary source  for  star  names,  which  are  assigned  only  to  the  brighter  stars. 
All  other  data  contained  in  the  YBSC  is  available  in  one  or  more  of  the  other 
source  catalogs,  and  thus  is  not  taken  from  the  YBSC. 
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ABSTRACT 


This  document  describes  a comparison  of  star  positions  and  proper  motions 
between  the  Smithsonian  Astrophysical  Observatory  (SAO)  Star  Catalog  and  the 
Dritter  Katalog  der  Astronomischen  Gesellschaft  (AGK-3)  Star  Catalog.  No 
evidence  was  found  to  dispute  the  accuracies  in  position  and  proper  motion 
quoted  in  the  two  catalogs.  A small  fraction  of  stars  showed  large  discrepan- 
cies in  position  or  proper  motion.  The  reasons  for  these  apparent  errors  were 
investigated.  Based  on  the  results  of  this  study,  it  is  recommended  that  AGK-3 
positions  be  substituted  for  Henry  Draper  positions  in  SKYMAP,  but  not  for 
SAO  positions.  It  is  also  recommended  that  approximately  2000  "new"  stars 
found  in  the  AGK-3  be  included  in  SKYMAP. 
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SECTION  1 - INTRODUCTION 


SKY  MAP  (Reference  1)  star  positions  and  proper  motions  are  obtained  primarily 
from  the  Smithsonian  Astrophysical  Observatory  (SAO)  star  catalog  (Refer- 
ence 2).  However,  about  25  percent  of  SKYMAP  stars  are  not  in  the  SAO  cata- 
log; for  these  stars,  positions  have  been  obtained  from  the  Henry  Draper  (HD) 
catalog  (Reference  3)  and  their  proper  motions  have  been  defaulted  to  zero. 

The  SAO  positions  are  accurate  to  better  than  1 arc-second,  and  the  proper 
motions  are  accurate  to  about  1.5  arc-seconds  per  century.  However,  the  HD 
positional  accuracy  is  only  about  35  arc-seconds.  Because  typical  star  camera 
accuracies  are  between  2 and  10  arc-seconds,  the  SAO  positions  and  proper 
motions  are  adequate  for  the  analysis  of  star  camera  data.  The  HD  positions, 
however,  have  such  large  errors  that  catalog  accuracy  often  limits  the  attain- 
able attitude  accuracy. 

To  resolve  this  problem,  an  attempt  was  made  to  improve  the  positions  of  those 
SKYMAP  stars  not  having  SAO  positions  by  obtaining  positional  data  from  the 
new  AGK-3  catalog  (Reference  4).  The  AGK-3  is  a recent  (1974-1976)  revision 
of  the  AGK-2  catalog  (Reference  5),  from  which  many  SAO  positions  were  taken. 
AGK-3  is  reported  to  be  more  accurate  than  the  SAO  in  both  position  and  proper 
motion  (Reference  6).  Furthermore,  the  AGK-3  contains  a number  of  stars 
not  in  the  SAO  catalog.  However,  this  catalog  has  never  been  fully  quality- 
assured.  To  determine  the  reliability  and  accuracy  of  the  AGK-3,  a study  was 
made  of  the  differences  in  position  and  proper  motion  for  those  stars  listed  in 
both  the  SAO  and  the  AGK-3. 
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SECTION  2 - COMPARISON  OF  SAP  AND  AGK-3  CATALOGS 
2.1  TECHNIQUE 

Because  the  SAO  does  not  contain  AGK-3  numbers  and  the  AGK-3  does  not 
quote  SAO  numbers,  stars  in  the  two  catalogs  had  to  be  identified  with  one 
another  through  their  Durchmusterung  (DM)  numbers.  Approximately  70  per- 
cent of  AGK-3  stars  were  thereby  identified  with  about  45  percent  of  SAO  stars. 
For  stars  which  could  be  identified  in  this  manner,  the  difference  in  positions 
was  formulated: 


' 6 SAO  " 5AGK-3 1 


A CL  - I fV  - OL  _ I / COS  (6  ) 

1 SAO  AGK-31  ' SAO; 


(2-1) 


where 


^SAO 

^AGK-3 

ttSAO 

aAGK-3 


= declination  in  the  SAO, 

= declination  in  the  AGK-3 , 

= right  ascension  in  the  SAO,  and 
= right  ascension  in  the  AGK-3. 


The  difference  in  proper  motion  was  similarly  computed.  The  results  are  pre- 
sented in  Tables  2-1  and  2-2. 

2.2  ACCURACY  OF  STAR  POSITIONS 

The  estimated  error  in  SAO  positions  is  typically  0.5  arc-second  (Reference  2); 
for  the  AGK-3  it  is  0.2  arc-second  (Reference  6).  Therefore,  the  distribution 
of  A£  and  A a as  defined  in  Equation  (2-1)  should  be  a Gaussian  with  standard 
deviation 


(0.2)  « 0.55  arc-seconds 


(2-2) 
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Table  2-1.  Distribution  of  Differences  in  SAO  and 
AGK-3  Star  Positions 


DIFFERENCE  IN  POSITION 

NUMBER  OF  STARS 

RIGHT  ASCENSION 

DECLINATION 

< 0.5  ARC-SECONDS 

91,708 

108,226 

0.5  - 1 .0  ARC-SECONDS 

32,934 

18.788 

1.0-  1.5  ARC-SECONDS 

2,951 

1,863 

1.5  - 2.0  ARC-SECONDS 

1,344 

262 

2.0  - 2.5  ARC-SECONDS 

174 

73 

2.5 -3.0  ARC-SECONDS 

111 

48 

3.0  - 3.5  ARC-SECONDS 

69 

43 

3.5  - 4.0  ARC-SECONDS 

37 

27 

4.0 -4.5  ARC-SECONDS 

46 

35 

>4.5  ARC-SECONDS 

1,532 

1,541 

TOTAL  TESTED 

130,906 

130,906 
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Table  2-2.  Distribution  of  Differences  in  SAO  and 
AGK-3  Proper  Motions 


DIFFERENCE  IN  PROPER  MOTION 

NUMBER  OF  STARS 

DEGREE/YEAR 

ARC— SECONDS/IOO  YEARS 

RIGHT  ASCENSION 

DECLINATION 

< 0.00001 

<3.6 

124,535 

125,458 

0.00001  - 0.00002 

3.6  - 7.2 

5,842 

5,103 

0.00002  - 0.00003 

7.2-10.8 

268 

145 

0.00003  - 0.00004 

10.8-14.4 

70 

33 

0.00004  - 0.00005 

14.4-18.0 

38 

34 

0.00005  - 0.00006 

18.0-21.6 

23 

15 

0.00006  - 0.00007 

21.6-25.2 

19 

11 

0.00007  - 0.00008 

25.2  - 28.8 

10 

10 

0.00008  - 0.00009 

28.8  - 32.4 

10 

12 

> 0.00009 

> 32.4 

91 

85 

TOTAL 

130306 

130,906 
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The  distribution  presented  in  Table  2-1  is  consistent  with  this  result,  except  for 
a small  fraction  of  stars  having  large  errors.  The  large  errors  are  relevant  to 
a discussion  of  catalog  reliability,  but  not  to  a study  of  accuracy.  No  evidence 
■was  found  to  dispute  the  quoted  star  position  accuracies  of  the  SAO  and  AGK-3 
catalogs;  neither  can  this  study  confirm  the  quoted  accuracies,  because  the 
data  on  which  the  SAO  and  AGK-3  are  based  is  not  entirely  independent  (both 
catalogs  depend  partially  on  the  AGK-2  catalog). 

The  large  errors  (>  4. 5 arc-seconds)  were  further  investigated  by  studying 
a random  sample  of  100  cases.  In  63  percent  of  these  cases,  there  was  an 
apparent  error  in  the  DM  number  used  to  identify  an  SAO  star  with  an  AGK-3 
star.  The  error  could  be  in  the  AGK-3  or  the  SAO,  but  in  either  case  it  led 
to  an  erroneous  identification,  and  therefore  to  a large  position  error.  The 
remaining  37  percent  of  the  differences  are  unexplained. 

A summary  of  the  percentage  occurrence  results  from  comparison  of  AGK-3 
and  SAO  star  positions  is  as  follows:  the  difference  consistent  with  quoted 
errors  was  98  percent,  the  difference  due  to  DM  number  error  was  1.2  per- 
cent, and  the  difference  greater  than  4.5  arc-seconds  and  unexplained  was 
0. 8 percent. 

2.  3 ACCURACY  OF  PROPER  MOTIONS 

The  quoted  error  for  proper  motions  in  the  SAO  catalog  is  typically  about 
1.5  arc-seconds  per  100  years  (Reference  2);  for  the  AGK-3  it  is  0.8  arc- 
seconds  per  100  years  (Reference  6).  Using  an  argument  similar  to  the  one 
employed  for  position  errors,  it  is  projected  that  the  difference  in  proper 
motions  would  follow  a Gaussian  with  standard  deviation  of  about  1. 7 arc- 
seconds. 

The  distribution  presented  in  Table  2-2  is  consistent  with  this  result  except 
for  a very  few  large  errors.  No  evidence  was  found  to  contradict  the  errors 
quoted  in  the  SAO  and  AGK-3  catalog  for  proper  motions.  Once  again,  these 
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error  estimates  cannot  be  verified  because  the  data  presented  in  the  two 
catalogs  are  not  totally  independent. 

A random  sample  of  100  proper  motions  errors  greater  than  32.4  arc-seconds 
per  hundred  years  was  investigated.  Nineteen  percent  of  these  were  found  to  be 
due  to  a mispunch  in  the  most  significant  column  of  the  AGK-3  catalog  proper 
motion,  leading  to  enormous  proper  motions.  The  others  are  unexplained, 
but  could  be  the  tail  of  the  Gaussian  distributions. 

A summary  of  the  percentage  occurrence  results  from  comparison  of  AGK-3 
and  SAO  proper  motions  is  as  follows:  the  difference  consistent  with  quoted 
errors  was  99. 8 percent,  the  difference  due  to  AGK-3  mispunch  was  less  than 
0. 1 percent,  and  the  difference  greater  than  32.4  arc-seconds  per  100  years 
and  unexplained  was  0.2  percent. 

2.4  NEW  STARS  FOUND  IN  THE  AGK-3  CATALOG 

Of  the  183, 145  AKG-3  stars,  48,638  were  found  in  neither  the  SAO  or  HD 
catalogs,  or  could  not  be  cross-referenced  to  these  catalogs  due  to  DM  number 
errors.  A breakdown  of  this  number  by  photographic  magnitude  includes 
856  stars  brighter  than  9.0,  8,710  stars  with  magnitudes  ranging  from  9.0  to 
10.0,  and  39,072  stars  dimmer  than  10.0. 

About  2000  of  these  start  are  brighter  than  the  limiting  magnitude  of  SKYMAP. 
Including  them  in  SKYMAP  would  increase  its  completeness  by  between  1 and 
2 percent  at  the  9.0-magnitude  level. 
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SECTION  3 - CONCLUSIONS  AND  RECOMMENDATIONS 


It  is  recommended  that  the  AGK-3  positions  and  proper  motions  be  substituted 
for  those  SKYMAP  positions  currently  derived  from  HD  data.  The  risk  of 
large  error  is  about  2 percent,  but  most  of  these  "large"  errors  are  still 
smaller  than  the  current  35-arc-second  uncertainties. 

It  is  also  recommended  that  the  AGK-3  positions  and  proper  motions  not  be 
substituted  for  those  SKYMAP  positions  currently  derived  from  SAO  data.  The 
current  accuracy  of  SAO  positions  is  sufficient  for  all  applications  currently 
projected.  Substituting  AGK-3  data  would  introduce  about  2 percent  large 
errors  without  counterbalancing  benefit. 

Finally,  this  study  concludes  that  the  AGK-3  stars  not  found  in  the  SAO  and  the 
HD  be  added  to  SKYMAP.  This  will  increase  the  completeness  of  SKYMAP 
by  between  1 and  2 percent  at  9. 0 magnitude.  Less  than  1 percent  of  the  stars 
so  introduced  will  have  position  errors  greater  than  4.5  arc-seconds.  Another 
1 percent  will  have  correct  positions  but  incorrect  DM  numbers.  This  risk 
seems  acceptable  in  the  view  of  the  additional  completeness  gained. 
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